Sign in

v1

latestOpenAPI 3.0.22026-07-26123510445.2 KB
Transactions

List Cards Transactions

Returns a list of issuing transaction objects. The objects are sorted in descending order by creation date, with the most recently created object appearing first.

get/v1/issuing/transactions

Query parameters

page_sizeinteger required
Example:10

The maximum number of items to return per page. This number can be between 1 - 100

page_numberinteger required
Example:1

The page number to retrieve the next set of items. The number has to be greater than 1.

card_idstring uuid
Example:b3d9d2d5-4c12-4946-a09d-953e82sed2b0

Universally unique identifier (UUID v4) of a card.

start_timestring
Example:2024-03-21T09:17:32Z

The earliest transaction creation time to filter by, in ISO 8601 format. The maximum time interval between start_time and end_time is 90 days.

When the value includes a timezone offset such as +08:00, the + character must be URL-encoded as %2B in the query string — otherwise the server interprets it as a space and rejects the request. Example: start_time=2024-03-21T17:17:32%2B08:00. UTC values ending with Z (e.g., 2024-03-21T09:17:32Z) do not require encoding.

end_timestring
Example:2024-03-21T09:17:32Z

The latest transaction creation time to filter by, in ISO 8601 format. The maximum time interval between start_time and end_time is 90 days.

When the value includes a timezone offset such as +08:00, the + character must be URL-encoded as %2B in the query string — otherwise the server interprets it as a space and rejects the request. Example: end_time=2024-03-21T17:17:32%2B08:00. UTC values ending with Z (e.g., 2024-03-21T09:17:32Z) do not require encoding.

Headers

x-on-behalf-ofstring

Specifies the sub-account on whose behalf the request is made. This should be set to the account_id, which can be retrieved via the List Connected Accounts API. If omitted or empty, the request is executed using the master account. More information at Connected Accounts.

Response

OK - Card transactions returned successfully.

total_pagesinteger

The total pages of available items.

total_itemsinteger

The total counts of available items.

Example response

{
  "total_pages": 10,
  "total_items": 105,
  "data": [
    {
      "card_id": "c0cef051-29c5-4796-b86a-cd5b684bfad7",
      "card_number": "************5668",
      "cardholder_id": "7c4ff2cd-1bf6-4aaa-bf16-266771425011",
      "transaction_id": "5135e6cc-28b6-4889-81dc-3b86a09e1395",
      "short_transaction_id": "CT2024-03-01",
      "original_transaction_id": "1234e6cc-28b6-4889-81dc-3b86a09e1395",
      "transaction_type": "AUTHORIZATION",
      "transaction_fee": 0.25,
      "transaction_fee_currency": "SGD",
      "fee_pass_through": "Y",
      "card_available_balance": 2506.26,
      "billing_amount": 70.25,
      "billing_currency": "SGD",
      "transaction_amount": 100.25,
      "transaction_currency": "USD",
      "transaction_time": "2024-03-21T17:17:32+08:00",
      "posted_time": "2024-03-21T17:17:32+08:00",
      "merchant_data": {
        "category_code": "6011",
        "city": "CITY NAME",
        "country": "CN",
        "name": "ACQUIRER NAME"
      },
      "description": "1107 - Invalid CVV2",
      "transaction_status": "DECLINED",
      "wallet_type": "ApplePay"
    }
  ]
}