Retrieve Assets From ID

This guide outlines how to utilize with Spinwheel’s Credit Card Brand Asset endpoint to retrieve the card program name and artwork by providing the userId.

Overview

If you already use Spinwheel’s Debt Profile APIs, retrieving card brand assets is simple. Provide the userId to retrieve brand assets in a single call for all eligible credit cards or include one or more creditCardIdfor specific card details.

Endpoint

The full API reference can be found here: Retrieve Credit Card Brand for Connected User.

GET /v1/creditCards?userId={userId}&creditCardIds[]={creditCardId} for specific card assets

📘

Syntax

Please note that you must use the square brackets syntax if you want to filter for specific cards e.g. creditCardIds[]=abc&creditCardIds[]=def

GET /v1/creditCards?userId={userId} for all credit card assets

Example Response

{
  "status": {
    "code": 200,
    "desc": "success",
    "messages": [
      {
        "desc": "Example description"
      }
    ]
  },
  "data": {
    "userId": "user-123456",
    "creditCards": [
      {
        "extCreditCardId": "147500249-1098-1221-2168-6122859797551",
        "creditCardName": "Chase Freedom Visa Signature",
        "creditCardArtUrl": "https://cdn.spinwheel.io/images/logo/c7f3e805b4ac4b828aa7f7ca1157939d.png",
        "status": "SUCCESS"
      },
      {
        "extCreditCardId": "147500249-1098-1221-2168-6122859797552",
        "status": "CREDIT_CARD_NOT_SUPPORTED"
      }
    ]
  }
}

Notes

  • If the card isn’t supported, the status will reflect that.
  • Card art URLs may change over time as issuers update their designs, re-fetch periodically to stay up to date.