List Top-Up History

GET

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

Returns paginated top-up history for a specific card, optionally filtered by date range.

📤 Response Fields (per item)

Field	Type	Description	Notes
`id`	`string (uuid)`	-	-
`card_id`	`string (uuid)`	-	-
`amount`	`number`	-	-
`fee`	`number`	Fee charged for this top-up.	-
`currency`	`string`	-	-
`status`	`string`	-	-
`transaction_reference`	`string`	-	nullable
`created_at`	`string (date-time)`	-	-

Request

Path Params

Query Params

Header Params

Responses

🟢200

application/json

Top-up history retrieved.

Body

🟠401

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

200 - Example 1

{}

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

Get Card Balance

List All Transactions

List Top-Up History

📤 Response Fields (per item)#

Request

Responses

📤 Response Fields (per item)