GET/v1/cards

List cards

Returns every virtual card issued to the authenticated user.

Required scope: cards.readRate limit: 10 rps

Code samples

curl -X GET "https://samaprime.com/api/v1/cards" \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json"

Response

→ 200
{
  "data": [
    {
      "id": "cm_card_01J8Z1A2BBCCDD",
      "tier": "plus",
      "status": "active",
      "last4": "1234",
      "cardholder_name": "J. Doe",
      "balance_usd": "37.0100",
      "nickname": "Groceries card"
    }
  ],
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2026-08-06T12:00:00Z"
  }
}