Skip to main content
GET
/
get-card-data
Get card details
curl --request GET \
  --url https://laso.finance/get-card-data \
  --header 'Authorization: Bearer <token>'
{
  "card_id": "<string>",
  "usd_amount": 123,
  "country": "US",
  "label": "<string>",
  "charged_usd_amount": 123,
  "fees_paid": 123,
  "balance_update_requested_timestamp": 123,
  "queued_order_card_id": "<string>",
  "timestamp": 123,
  "timestamp_readable": "<string>",
  "last_updated_timestamp": 123,
  "card_details": {
    "card_number": "<string>",
    "exp_month": "<string>",
    "exp_year": "<string>",
    "cvv": "<string>",
    "available_balance": 123
  },
  "transactions": [
    {
      "amount": 123,
      "date": "<string>",
      "description": "<string>",
      "is_credit": true
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://agents.laso.finance/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

ID token from /auth or /get-card

Query Parameters

​
card_id
string

The card ID returned from /get-card or /order-intl-card. If omitted, returns all cards for the user.

​
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.

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

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. When status is ready, card_details contains the card number, CVV, and expiry. International cards include extra fields (label, charged_usd_amount, fees_paid, state, balance_update_requested_timestamp, queued_order_card_id).

​
card_id
string
​
card_type
enum<string>
Available options:
Non-Reloadable U.S.,
Non-Reloadable International
​
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.