Skip to main content

List card transactions

GET 
/v1/cards/transactions

Retrieves all transactions for a specific card with optional filters.

Request​

Query Parameters

    cardId stringrequired

    The ID of the card to retrieve transactions for

    parentCardTransactionId string

    Filter by parent card transaction ID to group related transactions

    type string

    Possible values: [PRE_AUTHORIZATION, PRE_AUTH_COMPLETION, REVERSAL_ADVICE, PURCHASE, ONLINE_TRANSACTION, REFUND, CREDIT, BALANCE_INQUIRY, ACCOUNT_VERIFICATION]

    Filter by card transaction type (PRE_AUTHORIZATION, PRE_AUTH_COMPLETION, REVERSAL_ADVICE, etc.). PURCHASE is the canonical value; ONLINE_TRANSACTION is accepted as a temporary alias during transition.

    status string

    Possible values: [PENDING, COMPLETED, FAILED, CANCELLED, PROCESSED]

    Filter by transaction status (PENDING, COMPLETED, FAILED, CANCELLED)

    operation string

    Possible values: [CREDIT, DEBIT]

    Filter by operation (CREDIT, DEBIT)

    createdAfter string

    Filter transactions created after this date (YYYY-MM-DD)

    createdBefore string

    Filter transactions created before this date (YYYY-MM-DD)

    limit number
    offset number

Responses​

Successfully retrieved card transactions.

Schema

    traceId string
    message string

    data

    object[]

  • Array [

    • id stringrequired

    Unique transaction ID (child ID)

    parentCardTransactionId string

    Parent card transaction ID for grouping related events

    cardId stringrequired

    Card ID (credit or debit)

    cardType stringrequired

    Possible values: [CREDIT, DEBIT]

    Type of card (CREDIT or DEBIT)

    type string

    Possible values: [PRE_AUTHORIZATION, PRE_AUTH_COMPLETION, REVERSAL_ADVICE, PURCHASE, REFUND, CREDIT, BALANCE_INQUIRY, ACCOUNT_VERIFICATION]

    Transaction type

    operation string

    Possible values: [CREDIT, DEBIT]

    Transaction operation (CREDIT or DEBIT)

    status string

    Possible values: [PENDING, COMPLETED, FAILED, CANCELLED, PROCESSED]

    Transaction status (PENDING, COMPLETED, FAILED, CANCELLED)

    amount number

    Transaction amount

    asset stringrequired

    Asset acronym

    amounts

    object

    Detailed amount breakdown with surcharge and fees

    transaction number

    Transaction amount in major units

    transactionCurrency string

    Transaction currency

    settlement number

    Settlement amount (only present when different from transaction)

    settlementCurrency string

    Settlement currency (only present when different from transaction currency)

    surcharge number

    Surcharge/ATM fee

    settlementConversionRate number

    Settlement conversion rate

    fees

    object[]

    Fees from DE54 Additional Amounts (ATM fees, surcharges, interchange, network fees)

  • Array [

    • type string

    Fee type (e.g., ATM Fee, Surcharge, Network Fee)

    amount number

    Fee amount in major units

    currency string

    Fee currency code

  • ]

    • retrievalReferenceNo string

    Retrieval Reference Number (DE37)

    merchant

    object

    Merchant data

    name string

    Merchant name

    mcc string

    Merchant Category Code (DE18)

    city string

    Merchant city

    state string

    Merchant state/province

    country string

    Merchant country (ISO 3166-1 alpha-2)

    timestamp date-timerequired

    Transaction timestamp

  • ]

    • pagination

    object

    totalResults numberrequired
    hasMoreResults booleanrequired
Loading...