Skip to main content
GET
Get card details

Authorizations

Authorization
string
header
required

Firebase ID token from /auth or any paid route, sent as a Bearer token: Authorization: Bearer <id_token> (the Bearer prefix is required).

Query Parameters

card_id
string

The card ID returned from /get-card or /order-intl-card, or a reloadable card's id from card_type=Reloadable. Looked up across all three card types. If omitted, returns all cards of card_type.

card_type
enum<string>
default:Non-Reloadable U.S.

When listing all cards (no card_id), filters by card type. Defaults to Non-Reloadable U.S. if omitted (preserves existing client behavior). Pass Non-Reloadable International to list international cards, or Reloadable to list reloadable cards.

Available options:
Non-Reloadable U.S.,
Non-Reloadable International,
Reloadable
approval_id
string

Reloadable cards only, and only for a card the account holder created in a DIFFERENT app: pass the approval_id from a prior details_approval response once they have approved it. Cards created through /create-reloadable-card are Laso-issued and never require this.

Response

Card status and details. Returns a single CardData object when card_id is provided, or { "cards": CardData[] } when omitted.

Response from /get-card-data. Three card types share this shape and each populates a different subset.

Non-reloadable (U.S. and International): when status is ready, card_details carries the number, CVV, and expiry. International cards add label, charged_usd_amount, fees_paid, state, balance_update_requested_timestamp, and queued_order_card_id.

Reloadable: returns last4, expiry, balance, spend_limit, reusable, issuer_status, created_at, and expires_at instead of the usd_amount/timestamp fields above. Reading its number and CVV is gated by the card issuer, so exactly one of card_details, details_approval, or details_error is present on a single-card lookup.

card_id
string
card_type
enum<string>
Available options:
Non-Reloadable U.S.,
Non-Reloadable International,
Reloadable
usd_amount
number
country
string

U.S. cards only.

Example:

"US"

label
string | null

International cards only. User-supplied label, may be empty.

charged_usd_amount
number

International cards only. Amount the user was charged including fees.

fees_paid
number

International cards only. Fees paid for this card.

state
enum<string>

International cards only. Raw card state.

Available options:
queued,
redeemable,
complete,
refund-requested,
refund-requested-approved-for-queue,
archived,
refunded
balance_update_requested_timestamp
number | null

International cards only. Unix timestamp (ms) of an outstanding admin balance update request, or null if none is pending.

queued_order_card_id
string | null

International cards only. The original card_id returned by /order-intl-card. After admin fulfillment the card is reissued with a new card_id (the issuer's transaction id); querying /get-card-data?card_id=<original> continues to resolve to the fulfilled card via this field.

timestamp
number
timestamp_readable
string
last_updated_timestamp
number

U.S. cards only. Unix timestamp (ms) of the last time card data was refreshed.

status
enum<string>
Available options:
pending,
ready,
queued,
complete,
refund-requested,
refunded,
archived
card_details
object

Only present when status is ready (U.S.) or complete (international).

transactions
object[]

Card transaction history. U.S. and international cards use slightly different shapes — see CardTransaction and IntlCardTransaction.

U.S. prepaid card transaction.

last4
string

Reloadable cards only. Last four digits.

Example:

"8260"

expiry
string

Reloadable cards only. MM/YY.

Example:

"07/31"

balance
number

Reloadable cards only. Spendable balance in dollars.

Example:

208

spend_limit
number

Reloadable cards only. Spend cap in dollars.

Example:

208

reusable
boolean

Reloadable cards only. True for a multi-use card.

issuer_status
string

Reloadable cards only. The issuer's own status string, kept verbatim.

Example:

"OPEN"

created_at
number

Reloadable cards only. Epoch milliseconds.

expires_at
number | null

Reloadable cards only. Epoch milliseconds, or null when the card does not expire.

details_approval
object | null

Reloadable cards only, and only for a card the holder created in ANOTHER app. The issuer has emailed them an approve/deny link; retry with approval_id once they approve. Cards created through /create-reloadable-card are Laso-issued and never take this path.

details_error
string | null

Reloadable cards only. Present when the issuer could not return the number, so a card with no card_details is never silently indistinguishable from one whose details are pending.