List cards

Retrieve a paginated list of cards. Cards can be filtered by cardholder, bound funding-source internal account, state, and platform-specific card identifier. If no filters are provided, returns all cards visible to the caller.

GET /cards

cURL

cURL

curl --request GET \
  --url https://api.lightspark.com/grid/2025-10-13/cards \
  --header 'Authorization: Basic <encoded-value>'

200

{
  "data": [
    {
      "id": "Card:019542f5-b3e7-1d02-0000-000000000010",
      "cardholderId": "Customer:019542f5-b3e7-1d02-0000-000000000001",
      "fundingSources": [
        "InternalAccount:019542f5-b3e7-1d02-0000-000000000002",
        "InternalAccount:019542f5-b3e7-1d02-0000-000000000003"
      ],
      "createdAt": "2026-05-08T14:10:00Z",
      "updatedAt": "2026-05-08T14:11:00Z",
      "platformCardId": "card-emp-aary-001",
      "last4": "4242",
      "expMonth": 12,
      "expYear": 2029,
      "panEmbedUrl": "https://embed.lithic.com/iframe/...?t=...",
      "currency": "USD",
      "issuerRef": "lithic_card_4f8d3a2b1c"
    }
  ],
  "hasMore": true,
  "nextCursor": "<string>",
  "totalCount": 123
}

Authorizations

Authorization · string · header · required

API token authentication using format <api token id>:<api client secret>

Query Parameters

cardholderId · string

Filter by cardholder (customer) id.

accountId · string

Filter by internal account id. Returns cards whose fundingSources array contains the given internal account id.

platformCardId · string

Filter by platform-specific card identifier.

state · enum<string>

Filter by card state. Lifecycle state of a card.

State	Description
PENDING_KYC	The cardholder has not yet completed KYC. Cards in this state cannot transact.
PENDING_ISSUE	The card has been requested and is being provisioned with the issuer.
ACTIVE	The card is live and can authorize transactions.
FROZEN	The card is temporarily disabled by the platform. New authorizations are declined with CARD_PAUSED. Existing settlements and refunds continue to reconcile.
CLOSED	The card is permanently closed. Terminal, irreversible state.

Available options: PENDING_KYC, PENDING_ISSUE, ACTIVE, FROZEN, CLOSED

limit · integer · default: 20

Maximum number of results to return (default 20, max 100)

Required range: 1 <= x <= 100

cursor · string

Cursor for pagination (returned from previous request)

sortOrder · enum<string> · default: desc

Order to sort results in

Available options: asc, desc

Response

200

application/json

Successful operation

data · object[] · required

List of cards matching the filter criteria

Show child attributes

hasMore · boolean · required

Indicates if more results are available beyond this page

nextCursor · string

Cursor to retrieve the next page of results (only present if hasMore is true)

totalCount · integer

Total number of cards matching the criteria (excluding pagination)