GET/v1/cards/:id

Get a card

Returns a single card's status and balance (never full number/CVV — see Reveal).

Required scope: cards.readRate limit: 10 rps

Parameters

idstringrequired

The card ID.

Code samples

curl -X GET "https://samaprime.com/api/v1/cards/smsord_01J8X9AABBCCDD" \
  -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",
    "expiry_month": 12,
    "expiry_year": 29
  },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2026-08-06T12:00:00Z"
  }
}

Errors

Status	Code
404	`not_found` No card with this ID belongs to this user.