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, ONLINE_TRANSACTION, REFUND, CREDIT, BALANCE_INQUIRY, ACCOUNT_VERIFICATION]

Filter by card transaction type (PRE_AUTHORIZATION, PRE_AUTH_COMPLETION, REVERSAL_ADVICE, etc.)

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

200

Successfully retrieved card transactions.

application/json

Schema

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, ONLINE_TRANSACTION, 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

timestamp date-timerequired

Transaction timestamp

]

pagination

object

totalResults numberrequired

hasMoreResults booleanrequired

Example (from schema)

{
  "traceId": "string",
  "message": "string",
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "parentCardTransactionId": "987fcdeb-51a2-43b8-96cd-ba321f098765",
      "cardId": "987fcdeb-51a2-43b8-96cd-ba321f098765",
      "cardType": "CREDIT",
      "type": "PRE_AUTHORIZATION",
      "operation": "DEBIT",
      "status": "COMPLETED",
      "amount": 100.5,
      "asset": "USD",
      "timestamp": "2024-07-29T15:51:28.071Z"
    }
  ],
  "pagination": {
    "totalResults": 0,
    "hasMoreResults": true
  }
}

400

Invalid request payload. This can happen if required fields are missing or have invalid formats.

application/json

Schema

Schema

traceId string
message string

Example (from schema)

{
  "traceId": "string",
  "message": "string"
}

403

The API key is invalid or the client does not have sufficient permissions.

application/json

Schema

Schema

traceId string
message string

Example (from schema)

{
  "traceId": "string",
  "message": "string"
}

404

One of the specified resources was not found. Does not apply for empty result set.

application/json

Schema

Schema

traceId string
message string

Example (from schema)

{
  "traceId": "string",
  "message": "string"
}

Loading...