Card Transactions

Retrieve a paginated list of transactions on a single card — fees, funding, purchases, refunds. Pagination is cursor-based.


Request

Retrieve a paginated list of transactions on a single card via GET /api/cards/:cardId/transactions. Pagination is cursor-based.

Card Transactions

Query Parameters
1
cursorstringOptional

Opaque base64 pagination cursor. Pass data.page_info.next_cursor from the previous response to fetch the next page, or data.page_info.previous_cursor to go back. Omit on the first request.

2
limitnumberOptional

Maximum number of records to return per page. Default 20.

3
typestringOptional

Filter by transaction type (e.g. 'fee', 'funding', 'purchase', 'refund', 'withdrawal').

4
statusstringOptional

Filter by transaction status (e.g. 'pending', 'completed', 'failed').

Response Fields
1
data.transactionsArray<Transaction>

Page of card transaction records.

2
idUUID

Unique identifier of the transaction.

3
card_idUUID

Identifier of the card this transaction belongs to.

4
company_idUUID

Identifier of the company that owns the card.

5
typeString

Transaction type: 'fee', 'funding', 'purchase', 'refund', 'withdrawal'.

6
statusString

Lifecycle status: 'pending', 'completed', or 'failed'.

7
amountString

Transaction amount as an integer string in the card's smallest unit (e.g. '5000000' = $50.00 on a USD card).

8
currencyString

Currency of the transaction.

9
display_amountNumber

Transaction amount as a decimal number for display.

10
balance_beforeString

Card balance immediately before this transaction, in the smallest unit.

11
balance_afterString

Card balance immediately after this transaction, in the smallest unit.

12
fee_amountString

Fee charged for this transaction, in the smallest unit. Zero when no fee applies.

13
fee_typeString

Category of the fee (e.g. 'CARD_CREATION_FEE', 'CARD_TOPUP_FEE'). Empty when fee_amount is zero.

14
referenceString

Server-generated reference string for this transaction.

15
descriptionString

Human-readable description of the transaction (e.g. 'Card creation fee', 'Initial card funding').

16
metadataString

Stringified JSON of metadata attached at transaction time.

17
cardholder_nameString

Name on the card at the time of the transaction.

18
last_four_digitString

Last four digits of the card PAN at the time of the transaction. Present on transactions against a provisioned card.

19
provider_transaction_idString

Identifier returned by the downstream card processor (e.g. Miden). Use it when opening support tickets with the provider. Not present on purely internal transactions like creation fees.

20
created_byUUID

Identifier of the user or operator that initiated the transaction.

21
transaction_dateDate

RFC 3339 / ISO 8601 timestamp of when the transaction was recorded.

22
created_atDate

RFC 3339 / ISO 8601 timestamp of when the transaction record was created.

23
updated_atDate

RFC 3339 / ISO 8601 timestamp of the most recent update to the record.

24
failure_codeString

Machine-readable failure code. Only present when status is 'failed' (e.g. 'PROVIDER_REJECTED').

25
failure_reasonString

Human-readable explanation of the failure, often surfaced from the underlying card processor. Only present when status is 'failed'.

26
page_infoObject

Cursor-based pagination metadata.

27
has_next_pageBoolean

True when more records are available via next_cursor.

28
has_previous_pageBoolean

True when prior records are available via previous_cursor.

29
next_cursorString

Opaque base64 cursor for fetching the next page.

30
previous_cursorString

Opaque base64 cursor for stepping back one page.

31
totalInteger

Total number of transactions for this card matching the current filters.

Response Body

Get Card Transaction

Retrieve a single card transaction by its ID, scoped to a specific card. Use this to re-fetch an updated status after a webhook, or to confirm a specific provider_transaction_id / fee_amount before reconciling.

Get Card Transaction

Path Parameters
1
cardIdUUIDRequired

The card the transaction belongs to.

2
transactionIdUUIDRequired

The transaction to retrieve (from ID on the listing endpoint).

Same Shape As Listing

The returned data.transaction object uses the identical schema as entries in the Card Transactions list response — refer to that section for per-field docs, including the provider_transaction_id, failure_code, and failure_reason fields that may or may not be present depending on transaction type and status.

Response Body

Did you find this page useful?

Join our Discord