GET
/
api
/
v1
/
cards
/
transactions
Get paginated transactions for activated cards
const url = 'https://api.gnosispay.com/api/v1/cards/transactions';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}, body: undefined};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
[
  {
    "createdAt": "2024-01-15T14:30:00Z",
    "clearedAt": null,
    "isPending": true,
    "kind": "Payment",
    "status": "Approved",
    "country": {
      "name": "United Kingdom",
      "numeric": "826",
      "alpha2": "GB",
      "alpha3": "GBR"
    },
    "mcc": "5411",
    "merchant": {
      "name": "TESCO STORES",
      "city": "LONDON",
      "country": {
        "name": "United Kingdom",
        "alpha2": "GB"
      }
    },
    "billingAmount": "2550",
    "billingCurrency": {
      "symbol": "€",
      "code": "EUR",
      "decimals": 2,
      "name": "Euro"
    },
    "transactionAmount": "2199",
    "transactionCurrency": {
      "symbol": "£",
      "code": "GBP",
      "decimals": 2,
      "name": "British Pound"
    },
    "transactionType": "00",
    "cardToken": "4532********1234",
    "transactions": [
      {
        "status": "ExecSuccess",
        "to": "0x1234567890abcdef1234567890abcdef12345678",
        "value": "2550000000000000000000",
        "data": "0xa9059cbb",
        "hash": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
      }
    ]
  }
]

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
cardTokens
string

Comma-separated list of card tokens

​
limit
integer
default:100

Maximum number of transactions to return

Required range: x >= 10
​
offset
integer
default:0

Number of transactions to skip

Required range: x >= 0
​
before
string<date-time>

Filter transactions before this date (ISO 8601 format, e.g., "2023-04-01T00:00:00Z")

​
after
string<date-time>

Filter transactions after this date (ISO 8601 format, e.g., "2023-03-01T00:00:00Z")

​
billingCurrency
string

Filter by billing currency code

​
transactionCurrency
string

Filter by transaction currency code

​
mcc
string

Filter by Merchant Category Code (MCC)

​
transactionType
string

Filter by transaction type code (e.g., "00" for Purchase, "01" for Withdrawal)

Response

Successful response with paginated transaction events

​
count
integer

Total number of transactions available

Example:

25

​
next
string | null

URL for the next page of results, null if no more pages

Example:

"/api/v1/cards/transactions?limit=100&offset=100"

​
previous
string | null

URL for the previous page of results, null if on first page

Example:

null

​
results
object[]

Array of transaction events for the current page