Skip to main content
GET
/
cards
cURL
curl --request GET \
  --url https://api.lightspark.com/grid/2025-10-13/cards \
  --header 'Authorization: Basic <encoded-value>'
{
  "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
}

Documentation Index

Fetch the complete documentation index at: https://grid.lightspark.com/llms.txt

Use this file to discover all available pages before exploring further.

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.

StateDescription
PENDING_KYCThe cardholder has not yet completed KYC. Cards in this state cannot transact.
PENDING_ISSUEThe card has been requested and is being provisioned with the issuer.
ACTIVEThe card is live and can authorize transactions.
FROZENThe card is temporarily disabled by the platform. New authorizations are declined with CARD_PAUSED. Existing settlements and refunds continue to reconcile.
CLOSEDThe 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

Successful operation

​
data
object[]
required

List of cards matching the filter criteria

​
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)