API Response Structure
Pagination Parameters
ending_before
- Type: string
- Description: A cursor representing an item's token before which a page of results should end. Used to retrieve the previous page of results before this item.
page_size
- Type: integer
- Range: 1 to 100
- Defaults to: 50
- Description: Page size (for pagination).
starting_after
- Type: string
- Description: A cursor representing an item's token after which a page of results should begin. Used to retrieve the next page of results after this item.
Response Codes
200 OK
- Object:
- data
- Type: array of objects
- Required
- data
- Object:
- card_program_token
- Type: uuid
- Required: Globally unique identifier for the card program.
- created
- Type: date-time
- Required: Timestamp of when card art was created.
- description
- Type: string
- Required: Description of the card art.
- is_card_program_default
- Type: boolean
- Description: Whether the card art is the default card art to be added upon tokenization.
- is_enabled
- Type: boolean
- Required: Whether the card art is enabled.
- network
- token
- Type: uuid
- Required: Globally unique identifier for the card art.
- has_more
- Type: boolean
- Required: More data exists.
Error Codes
400
- A parameter in the query given in the request does not match the valid queries for the endpoint.
401
| Description |
Reason |
| 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
429
- Client has exceeded the number of allowed requests in a given time period.
| Description |
Reason |
| 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?page_size=50' \
--header 'accept: application/json'
Example Response
{
"data": [
{
"card_program_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"created": "2026-07-17T22:19:56.505Z",
"description": "string",
"is_card_program_default": true,
"is_enabled": true,
"network": "MASTERCARD",
"token": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
],
"has_more": true
}