GET
/
api
/
v1
/
transactions
Get transactions for activated cards
const url = 'https://api.gnosispay.com/api/v1/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);
}
[
  {
    "threadId": "1234567890",
    "createdAt": "2023-11-07T05:31:56Z",
    "clearedAt": "2023-11-07T05:31:56Z",
    "country": {
      "name": "<string>",
      "numeric": "<string>",
      "alpha2": "<string>",
      "alpha3": "<string>"
    },
    "isPending": true,
    "mcc": "<string>",
    "merchant": {
      "name": "<string>",
      "city": "<string>",
      "country": {
        "name": "<string>",
        "numeric": "<string>",
        "alpha2": "<string>",
        "alpha3": "<string>"
      }
    },
    "billingAmount": "<string>",
    "billingCurrency": {
      "symbol": "<string>",
      "code": "<string>",
      "decimals": 123,
      "name": "<string>"
    },
    "transactionAmount": "<string>",
    "transactionCurrency": {
      "symbol": "<string>",
      "code": "<string>",
      "decimals": 123,
      "name": "<string>"
    },
    "transactionType": "<string>",
    "cardToken": "<string>",
    "transactions": [
      {
        "status": "Unsubmitted",
        "to": "<string>",
        "value": "<string>",
        "data": "<string>",
        "hash": "<string>"
      }
    ],
    "kind": "Payment",
    "status": "Approved"
  }
]

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

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

threadId
string

Thread ID for the transaction

Example:

"1234567890"

createdAt
string<date-time>
clearedAt
string<date-time> | null

Date of the latest clearing record of the transaction

country
object
isPending
boolean

Whether the transaction is pending settlement.

  • For Payments: true when authorized but not yet cleared, false when settled
  • For Refunds: can be true if additional clearing steps are pending, typically false since they require both auth + clearing to appear
  • For Reversals: typically false as they're usually processed quickly
mcc
string
merchant
object
billingAmount
string

A BigInt value represented as a string

billingCurrency
object
transactionAmount
string

A BigInt value represented as a string

transactionCurrency
object
transactionType
string

First 2 digits of the DE3 field (ISO 8583), representing the transaction type code. Common values include (not limited to):

  • "00": Purchase (POS)
  • "01": Withdrawal (ATM)
  • "10": Account Funding
  • "20": Return of Goods
  • "28": Prepaid Load
  • "30": Balance Inquiry
  • "70": PIN Change
  • "72": PIN Unblock
cardToken
string

The token identifying the card used for this transaction

transactions
object[]
kind
enum<string>
Available options:
Payment
status
enum<string>
Available options:
Approved,
IncorrectPin,
InsufficientFunds,
ExceedsApprovalAmountLimit,
InvalidAmount,
PinEntryTriesExceeded,
IncorrectSecurityCode,
Reversal,
PartialReversal,
Other