Skip to main content
POST
Claim card session

Authorizations

Authorization
string
header
required

Bearer authentication: send your API key, agent key, or OAuth access token as Authorization: Bearer <credential>.

Headers

X-Instance-ID
string | null

Caller-chosen identifier for the agent run, session, or conversation, required when an agent moves money.

Maximum string length: 1024

Path Parameters

sessionId
string
required
Pattern: ^csn_[0-9a-f]{32}$

Response

Successful Response

sessionId
string
required
cardId
string
required
card
object
required
billingAddress
object | null
required

The card's billing address on file, for filling the merchant's checkout (the ZIP drives the bank's AVS check). Null for Natural-issued cards, which store none.

proxy
object
required
allowedHosts
string[]
required
expiresAt
string
required
Maximum string length: 64