Digital Card Art Token Documentation

digital_card_art_token

uuid
required
Specifies the digital card art to be displayed in the user’s digital wallet after tokenization. This artwork must be approved by Mastercard and configured by Lithic to use. See Flexible Card Art Guide.

200 OK

object

• card_program_token
  uuid
  required
  Globally unique identifier for the card program.

• created
  date-time
  required
  Timestamp of when card art was created.

• description
  string
  required
  Description of the card art.

• is_card_program_default
  boolean
  Whether the card art is the default card art to be added upon tokenization.

• is_enabled
  boolean
  required
  Whether the card art is enabled.

• network
  string
  enum
  required
  Card network.
  MASTERCARD VISA

• token
  uuid
  required
  Globally unique identifier for the card art.

Error Codes

• 400
  A parameter in the query given in the request does not match the valid queries for the endpoint.
• 401
  | User has not been authenticated | Invalid or missing API key |
  | API key is not active | The API key used is no longer active |
  | Could not find API key | The API key provided is not associated with any user |
  | Please provide API key in Authorization header | The Authorization header is not in the request |
  | Please provide API key in the form Authorization: [api-key] | The Authorization header is not formatted properly |
  | Insufficient privileges. Issuing API key required | Write access requires an Issuing API key. Reach out at lithic.com/contact |
  | Insufficient privileges to create virtual cards. | Creating virtual cards requires an additional privilege |
• 404
  The specified resource was not found.
• 422
  Unprocessable entity.
• 429
  Client has exceeded the number of allowed requests in a given time period.
  | Rate limited, too many requests per second | User has exceeded their per second rate limit |
  | Rate limited, reached daily limit | User has exceeded their daily rate limit |
  | Rate limited, too many keys tried | One IP has queried too many different API keys |

Example Curl Request

curl --request GET \
    --url https://sandbox.lithic.com/v1/digital_card_art/digital_card_art_token \
    --header 'accept: application/json'

Example Response

{
  "card_program_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "created": "2026-07-17T22:19:56.452Z",
  "description": "string",
  "is_card_program_default": true,
  "is_enabled": true,
  "network": "MASTERCARD",
  "token": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}