Get Card Balance

GET

{{baseUrl}}/api/v1/cards/{cardId}/balance

Returns the current balance of a card.

Balance fields:

available_balance — funds available for new transactions (after holds)

hold_amount — funds temporarily reserved for pending authorizations

total_balance — gross balance including held funds (available + hold)

📤 Response Fields

Field	Type	Description	Notes
`card_id`	`string (uuid)`	-	-
`available_balance`	`number`	Funds available for transactions. Example: `450.0`	-
`hold_amount`	`number`	Funds reserved for pending authorizations. Example: `50.0`	-
`total_balance`	`number`	Total balance including holds. Example: `500.0`	-
`currency`	`string`	- Example: `GBP`	-
`retrieved_at`	`string (date-time)`	-	-

Request

Path Params

Header Params

Responses

🟢200

application/json

Balance retrieved.

Body

🟠401

🟠404

Request Example

Shell

JavaScript

Java

Swift

curl --location -g --request GET '{{baseUrl}}/api/v1/cards/a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11/balance' \
--header 'X-API-Key;' \
--header 'X-Signature;' \
--header 'X-Timestamp;' \
--header 'X-Nonce;' \
--header 'X-Body-Hash;'

Response Example

200 - Success

{
    "data": {
        "card_id": "a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11",
        "available_balance": 450,
        "hold_amount": 50,
        "total_balance": 500,
        "currency": "GBP",
        "retrieved_at": "2024-01-15T10:30:00Z"
    }
}

Modified at 2026-02-18 13:25:16

Top Up Card

List Top-Up History

Get Card Balance

📤 Response Fields#

Request

Responses

📤 Response Fields