v1

latestOpenAPI 3.0.22026-07-26123510445.2 KB

Card Arts

List Card Arts

<a href="/card-issuance/v1.6/guide/card-products" style={{display:'inline-block',padding:'2px 10px',borderRadius:'9999px',fontSize:'12px',fontWeight:600,lineHeight:'18px',background:'#EEF2FF',color:'#4338CA',border:'1px solid #C7D2FE',textDecoration:'none'}}>Personal Visa only</a>

Returns the card arts available to the issuing account. The list combines the channel's system-default card art and any card arts bound to the account or its master account.

Use this endpoint to populate a card-art picker before creating or updating a card.

get/v1/issuing/cards/arts

Query parameters

card_product_idstring uuid

Example:467e993f-317a-49fc-9ea0-bf49de7d1f76

Filter the results to the card arts available for this card product. Omit to return all card arts available to the account.

Headers

x-on-behalf-ofstring

Specifies the sub-account on whose behalf the request is made. This should be set to the account_id, which can be retrieved via the List Connected Accounts API. If omitted or empty, the request is executed using the master account. More information at Connected Accounts.

Response

Card arts retrieved successfully.

default_card_art_idstring required

The issuing account's current default card art. A Create Card call that omits card_art_id uses this value.

Example response

{
  "default_card_art_id": "01KD52BKQWDMFF63R1NNQN7A79",
  "card_arts": [
    {
      "card_art_id": "01KD52BKQWDMFF63R1NNQN7A79",
      "description": "Premium Black",
      "is_default": true
    }
  ]
}