Skip to content
rigid.fi

Read a card's funding-account balance

GET/v1/cards/{id}/balance

Requires an API client bearer token.

Resolves the card's funding account and returns its balance, read straight from the ledger. The card must have a funding account (post-#214).

Parameters

Path parameters

NameRequiredDescription
idrequired

Example

curl https://api.rigid.fi/v1/cards/{id}/balance \
  -H "Authorization: Bearer $RIGID_API_TOKEN"

Responses

200

The card's funding-account balance.

card_idstringrequired
funding_account_idstringrequired
asset"EUR" | "GBP" | "USD"required
ledgerstringrequired
availablestringrequired
pending_instringrequired
heldstringrequired
400

Validation error

typestringrequired
titlestringrequired
statusintegerrequired
detailstring
instancestring
401

Authentication required

typestringrequired
titlestringrequired
statusintegerrequired
detailstring
instancestring
403

Forbidden

typestringrequired
titlestringrequired
statusintegerrequired
detailstring
instancestring
404

Card not found

typestringrequired
titlestringrequired
statusintegerrequired
detailstring
instancestring
409

The card has no funding account (pre-#214)

typestringrequired
titlestringrequired
statusintegerrequired
detailstring
instancestring
500

Internal server error

typestringrequired
titlestringrequired
statusintegerrequired
detailstring
instancestring