Get Top-Up Status
GET
/api/v1/funding/topup/{topupId}
202) until it reaches a terminal status.| Status | Meaning |
|---|---|
completed | Funds have been credited to the card |
processing | Still being processed |
failed | Could not be completed |
| Field | Type | Description |
|---|---|---|
topupId | string (uuid) | Top-up transaction identifier |
cardId | string (uuid) | Card the funds were loaded onto |
amount | number | Amount loaded |
currency | string | Currency loaded |
status | string | completed, processing, or failed |
newBalance | number | Card balance after the top-up (when status is completed) |
createdAt | string (date-time) | Timestamp the top-up was created |
Request
Path Params
Header Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/api/v1/funding/topup/9e8d7c6b-5a4f-4e3d-2c1b-0a9f8e7d6c5b' \
--header 'X-API-Key;' \
--header 'X-Signature;' \
--header 'X-Timestamp;' \
--header 'X-Nonce;' \
--header 'X-Body-Hash;'Response Response Example
200 - Success
{
"topupId": "9e8d7c6b-5a4f-4e3d-2c1b-0a9f8e7d6c5b",
"cardId": "6f1c9a2e-4b3d-4e7a-9c5f-1a2b3c4d5e6f",
"amount": 250,
"currency": "USDC",
"status": "completed",
"newBalance": 750,
"createdAt": "2026-01-15T11:35:00Z"
}Modified at 2026-08-10 11:54:40