List stored cards

The customer’s ACTIVE stored cards, newest first.

GET /customers/{customerId}/stored-cards

List stored cards

cURL

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

200

{
  "data": [
    {
      "lastFour": "0005",
      "brand": "VISA",
      "funding": "CREDIT",
      "expiryMonth": 8,
      "expiryYear": 2029,
      "id": "StoredCard:019542f5-b3e7-1d02-0000-000000000077",
      "customerId": "Customer:019542f5-b3e7-1d02-0000-000000000010",
      "status": "ACTIVE",
      "holderName": "Jane Doe",
      "agentIds": [
        "Agent:019542f5-b3e7-1d02-0000-000000000042"
      ],
      "createdAt": "2026-11-06T15:00:00Z",
      "updatedAt": "2026-11-06T15:00:00Z",
      "issuerCountry": "US",
      "nickname": "Personal Visa",
      "billingAddress": {
        "line1": "123 Main Street",
        "postalCode": "94105",
        "country": "US",
        "line2": "Apt 4B",
        "city": "San Francisco",
        "state": "CA"
      },
      "autoApprovals": [
        {
          "agentId": "Agent:019542f5-b3e7-1d02-0000-000000000042",
          "merchant": "example-store.com",
          "maxAmount": 4999,
          "currency": "USD"
        }
      ],
      "removedAt": "2026-11-07T09:30:00Z"
    }
  ]
}

Authorizations

Authorization · string · header · required

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

Path Parameters

customerId · string · required

System-generated unique customer identifier

Response

200

application/json

Successful operation

data · object[] · required

The customer's stored cards, newest first. REMOVED cards are not listed.

Maximum array length: 100

Show child attributes