List Top-Up History

GET

/api/v1/funding/{cardId}/topups

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

📤 Response Fields

Field	Type	Description
`data[].topupId`	`string (uuid)`	Top-up transaction identifier
`data[].amount`	`number`	Amount loaded
`data[].currency`	`string`	Currency loaded
`data[].status`	`string`	`completed`, `processing`, or `failed`
`data[].createdAt`	`string (date-time)`	Timestamp the top-up was created
`pagination.total`	`integer`	Total matching top-ups
`pagination.limit`	`integer`	Page size used
`pagination.offset`	`integer`	Items skipped
`pagination.hasMore`	`boolean`	Whether more pages exist

Request

Path Params

Query Params

Header Params

Responses

🟢200

application/json

Top-up history retrieved.

Bodyapplication/json

🟠401

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/v1/funding/6f1c9a2e-4b3d-4e7a-9c5f-1a2b3c4d5e6f/topups?limit=20&offset=0&from=2026-01-01T00%3A00%3A00Z&to=2026-01-31T23%3A59%3A59Z' \
--header 'X-API-Key;' \
--header 'X-Signature;' \
--header 'X-Timestamp;' \
--header 'X-Nonce;' \
--header 'X-Body-Hash;'

Response Example

200 - Success

{
    "data": [
        {
            "topupId": "9e8d7c6b-5a4f-4e3d-2c1b-0a9f8e7d6c5b",
            "amount": 250,
            "currency": "USDC",
            "status": "completed",
            "createdAt": "2026-01-15T11:35:00Z"
        },
        {
            "topupId": "1a2b3c4d-5e6f-4a3b-8c9d-0e1f2a3b4c5d",
            "amount": 100,
            "currency": "USDC",
            "status": "processing",
            "createdAt": "2026-01-14T09:00:00Z"
        }
    ],
    "pagination": {
        "total": 2,
        "limit": 20,
        "offset": 0,
        "hasMore": false
    }
}

Modified at 2026-08-10 11:54:40

Get Top-Up Status

Resend Activation Code