Skip to main content
GET
Get a card
Authoritative card state. An open card carries credentials (number, expiry, CVC) to key into the checkout. Every read of an open card notifies the member that its credentials were accessed. Fetch once when you are ready to pay; for progress, poll flow status instead. Never persist the credentials.

Authorizations

Authorization
string
header
required

The user's connection access_token (user authentication), or an org-minted buy_token for org-owned accounts.

Path Parameters

card_id
string
required

Response

The card.

A one-time virtual card created against the member's added card.

object
string
Example:

"card"

id
string
status
enum<string>

Envelope status. open carries credentials; approval_pending carries approval_url.

Available options:
approval_pending,
open,
in_use,
paused,
closed
spend_limit_cents
integer
balance_cents
integer
connected_card_id
string | null

The attachment this card draws on.

last4
string
expiry
string
Example:

"12/30"

created_at
string<date-time>
approval_url
string

Only while approval_pending: the page where the member approves this purchase with a passkey.

expires_at
string<date-time>

Only while approval_pending: when the approval window closes.

closed_reason
string

Only when closed: used, canceled, expired, or declined.

credentials
object

Only on an open card: the one-time credential to key into a checkout. Never persist it.

credentials_status
string

protected when the member requires an approval per reveal; retry when the credential read should be retried.