---
title: "Retrieve Credit Card Brand Information"
method: POST
path: "/v1/creditCards/brands"
tags: ["Credit Card Brands"]
---

# Retrieve Credit Card Brand Information

`POST /v1/creditCards/brands`

Retrieve credit card brand information for a user and their associated credit cards.

## Request body

- CreateCreditCardBrand
  - `extUserId` string, required — The external user ID to associate with these credit cards
  - `creditCards` CreditCardDetails[], required — Array of credit cards associated with the user
    - `extCreditCardId` string, required — The ID you want to use to reference this credit card
    - `creditCardNumberEncrypted` string, required — The encrypted credit card number using RSA-OAEP with SHA-256. Must be encrypted with Spinwheel's public key and encoded in base64 format.
    - `accountOriginationDate` string, required — The date the account was opened. Formatted as YYYY-MM-DD
    - `liabilitySubtype` 'CreditCard' | 'ChargeAccount' | 'BusinessCreditCard' | 'FlexibleSpendingCreditCard' | 'SecuredCreditCard', required — The type of credit card
    - `creditor` CreditCardCreditor, required
      - `originalName` string, required — The original name of the creditor
      - `address` RequiredAddress, required
        - `addressLine1` string, required
        - `city` string, required
        - `state` 'AL' | 'AK' | 'AZ' | 'AR' | 'CA' | 'CO' | 'CT' | 'DC' | 'DE' | 'FL' | 'GA' | 'HI' | 'ID' | 'IL' | 'IN' | 'IA' | 'KS' | 'KY' | 'LA' | 'ME' | 'MD' | 'MA' | 'MI' | 'MN' | 'MS' | 'MO' | 'MT' | 'Ne' | 'NE' | 'NV' | 'NH' | 'NJ' | 'NM' | 'NY' | 'NC' | 'ND' | 'OH' | 'OK' | 'OR' | 'PA' | 'RI' | 'SC' | 'SD' | 'TN' | 'TX' | 'UT' | 'VT' | 'VA' | 'WA' | 'WV' | 'WI' | 'WY', required
        - `zip` string, required

## Response `201`

Credit card brand information

- CreateCreditCardBrandOperationResponse
  - `data` CreditCardBrandData, required
    - `extUserId` string, required — The external user ID associated with these credit cards
    - `creditCards` CreditCardBrandResponse[], required — Array of credit card brand information
      - `extCreditCardId` string, required — The extCreditCardId you passed in the request
      - `creditCardName` string — The name of the card
      - `creditCardArtUrl` string — The URL for the card's artwork
      - `status` 'SUCCESS' | 'CREDIT_CARD_NOT_SUPPORTED' | 'INVALID_CARD_NUMBER' | 'UNKNOWN_ERROR' | 'CREDIT_CARD_ACCOUNT_CLOSED' | 'USER_INPUT_REQUIRED', required — Status of the card brand processing

## Other responses

- `400` — Bad request response
- `401` — Unauthorized response
- `404` — Not found response
- `500` — Internal server error response

---

[API](https://skmtc.dev/spinwheel/apis/discover.md) · [All operations](https://skmtc.dev/spinwheel/apis/discover/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/spinwheel/discover/revisions/55b90a2e1dd4/schema)