{
"transactions": [
{
"id": "342ea759-8870-418a-aa4c-ebc3a93ff70d",
"source_payment_id": "ab8861be-020f-6449-655e-c7b00ff71b74",
"reference": "Sent from Incard",
"payee_id": "6992e50e-dfd7-4d9c-891c-362ccfc01b58",
"payee_route": "local",
"company_id": "bebb185d-8210-4e66-ac63-397b49a1e09f",
"account_id": "0d6c0a2a-2b08-49bc-89a9-eb936c9ff28c",
"name": "ACME Corp",
"status": "completed",
"type": "out",
"direction": "debit",
"authorized_at": "2026-07-02T16:07:39.942Z",
"completed_at": "2026-07-02T16:08:11.104Z",
"transaction_at": "2026-07-02T16:07:39.917Z",
"account_amount": {
"value": "-300.00",
"currency": "GBP"
},
"transaction_amount": {
"value": "-300.00",
"currency": "GBP"
},
"base_amount": {
"value": "-300.00",
"currency": "GBP"
},
"running_balance": {
"value": "4700.00",
"currency": "GBP"
},
"user_id": "29b297ca-c617-437e-9c1d-32f494fbf44d",
"created_at": "2026-07-02T16:07:39.970773Z",
"updated_at": "2026-07-02T16:08:11.120114Z"
},
{
"id": "7f3c2a10-5d4e-4b8a-9c1d-2e3f4a5b6c7d",
"source_payment_id": "9e8d7c6b-5a4f-4e3d-2c1b-0a9f8e7d6c5b",
"company_id": "bebb185d-8210-4e66-ac63-397b49a1e09f",
"account_id": "0d6c0a2a-2b08-49bc-89a9-eb936c9ff28c",
"name": "Amazon",
"status": "pending",
"type": "card",
"direction": "debit",
"authorized_at": "2026-07-01T09:12:03.000Z",
"transaction_at": "2026-07-01T09:12:03.000Z",
"account_amount": {
"value": "-42.50",
"currency": "GBP"
},
"transaction_amount": {
"value": "-49.99",
"currency": "EUR"
},
"base_amount": {
"value": "-42.50",
"currency": "GBP"
},
"fx_rate": "1.176235",
"running_balance": {
"value": "5000.00",
"currency": "GBP"
},
"raw_merchant": {
"online": true,
"merchant_city": "LUXEMBOURG",
"merchant_country": "LU",
"mcc": "5942"
},
"merchant_id": "amazon",
"enriched_merchant": {
"icon_url": "https://cdn.incard.com/merchants/amazon.png",
"category": "Shopping",
"display_name": "Amazon"
},
"category_id": "883b6c21-9210-4e4a-9abe-3d9960face91",
"user_id": "29b297ca-c617-437e-9c1d-32f494fbf44d",
"card_token": "84de8ea0-e52a-4888-afd2-9d8dd5a42c20",
"created_at": "2026-07-01T09:12:03.412Z",
"updated_at": "2026-07-01T09:12:03.412Z"
}
],
"next_cursor": "eyJzb3J0IjoidHJhbnNhY3Rpb25fYXQiLCJkaXJlY3Rpb24iOiJkZXNjIiwidmFsdWUiOiIyMDI2LTA3LTAxVDA5OjEyOjAzWiIsImlkIjoiN2YzYzJhMTAtNWQ0ZS00YjhhLTljMWQtMmUzZjRhNWI2YzdkIn0"
}{
"error": "limit must be between 1 and 200"
}List transactions
Lists transactions for the company in X-On-Behalf-Of, newest first by transaction_at.
Results are limited to the accounts the API key’s member can access.
By default the list excludes future-scheduled payments and the internal reward types
loyalty_out, points_in, points_out, and trophy. Pass type to include a
specific type, or ids / source_payment_ids to look up rows regardless of these defaults.
Use cursor pagination (next_cursor → cursor) for large result sets. Offset pagination
(offset) also returns a total count but cannot be combined with cursor.
{
"transactions": [
{
"id": "342ea759-8870-418a-aa4c-ebc3a93ff70d",
"source_payment_id": "ab8861be-020f-6449-655e-c7b00ff71b74",
"reference": "Sent from Incard",
"payee_id": "6992e50e-dfd7-4d9c-891c-362ccfc01b58",
"payee_route": "local",
"company_id": "bebb185d-8210-4e66-ac63-397b49a1e09f",
"account_id": "0d6c0a2a-2b08-49bc-89a9-eb936c9ff28c",
"name": "ACME Corp",
"status": "completed",
"type": "out",
"direction": "debit",
"authorized_at": "2026-07-02T16:07:39.942Z",
"completed_at": "2026-07-02T16:08:11.104Z",
"transaction_at": "2026-07-02T16:07:39.917Z",
"account_amount": {
"value": "-300.00",
"currency": "GBP"
},
"transaction_amount": {
"value": "-300.00",
"currency": "GBP"
},
"base_amount": {
"value": "-300.00",
"currency": "GBP"
},
"running_balance": {
"value": "4700.00",
"currency": "GBP"
},
"user_id": "29b297ca-c617-437e-9c1d-32f494fbf44d",
"created_at": "2026-07-02T16:07:39.970773Z",
"updated_at": "2026-07-02T16:08:11.120114Z"
},
{
"id": "7f3c2a10-5d4e-4b8a-9c1d-2e3f4a5b6c7d",
"source_payment_id": "9e8d7c6b-5a4f-4e3d-2c1b-0a9f8e7d6c5b",
"company_id": "bebb185d-8210-4e66-ac63-397b49a1e09f",
"account_id": "0d6c0a2a-2b08-49bc-89a9-eb936c9ff28c",
"name": "Amazon",
"status": "pending",
"type": "card",
"direction": "debit",
"authorized_at": "2026-07-01T09:12:03.000Z",
"transaction_at": "2026-07-01T09:12:03.000Z",
"account_amount": {
"value": "-42.50",
"currency": "GBP"
},
"transaction_amount": {
"value": "-49.99",
"currency": "EUR"
},
"base_amount": {
"value": "-42.50",
"currency": "GBP"
},
"fx_rate": "1.176235",
"running_balance": {
"value": "5000.00",
"currency": "GBP"
},
"raw_merchant": {
"online": true,
"merchant_city": "LUXEMBOURG",
"merchant_country": "LU",
"mcc": "5942"
},
"merchant_id": "amazon",
"enriched_merchant": {
"icon_url": "https://cdn.incard.com/merchants/amazon.png",
"category": "Shopping",
"display_name": "Amazon"
},
"category_id": "883b6c21-9210-4e4a-9abe-3d9960face91",
"user_id": "29b297ca-c617-437e-9c1d-32f494fbf44d",
"card_token": "84de8ea0-e52a-4888-afd2-9d8dd5a42c20",
"created_at": "2026-07-01T09:12:03.412Z",
"updated_at": "2026-07-01T09:12:03.412Z"
}
],
"next_cursor": "eyJzb3J0IjoidHJhbnNhY3Rpb25fYXQiLCJkaXJlY3Rpb24iOiJkZXNjIiwidmFsdWUiOiIyMDI2LTA3LTAxVDA5OjEyOjAzWiIsImlkIjoiN2YzYzJhMTAtNWQ0ZS00YjhhLTljMWQtMmUzZjRhNWI2YzdkIn0"
}{
"error": "limit must be between 1 and 200"
}Authorizations
Short-lived access token. Obtain with your api_key.
Query Parameters
Comma-separated account UUIDs to include.
Comma-separated ISO 4217 account currencies (for example GBP,EUR).
Comma-separated ISO 4217 currencies the transaction was made in.
Comma-separated transaction UUIDs. Explicit lookups bypass the default type and scheduled exclusions.
Comma-separated identifiers of the payment in the originating source system.
Comma-separated statuses. One or more of pending, completed, declined, reversed.
Comma-separated transaction types. See the type field on the transaction object for values.
Comma-separated directions. One or both of debit, credit.
Comma-separated UUIDs of the users who initiated the transactions.
Comma-separated payee identifiers.
Comma-separated card tokens. Returns card transactions made with those cards.
Comma-separated category UUIDs.
true returns only categorised transactions, false only uncategorised.
Case-insensitive substring match against name and reference.
Inclusive lower bound on transaction_at (RFC 3339).
Inclusive upper bound on transaction_at (RFC 3339). Must not be before from.
Minimum absolute account amount (decimal string).
Maximum absolute account amount (decimal string). Must not be less than account_amount_min.
true returns only payments scheduled for today or later. false (default) excludes them.
true returns only transactions that earned points and adds points_totals_by_day to the response.
Sort field. Defaults to transaction_at.
transaction_at, completed_at, authorized_at, created_at Sort order. Defaults to desc.
asc, desc Page size, 1–200. Defaults to 50.
1 <= x <= 200Opaque next_cursor value from a previous page. Cannot be combined with offset.
Number of rows to skip. Enables the total count. Cannot be combined with cursor.
x >= 0true includes a user object (name and avatar) on each transaction that has a user_id.
true includes a card object (name, last four digits, type) on each card transaction.
Response
One page of transactions.
Transactions for the current page.
Show child attributes
Show child attributes
Opaque cursor for the next page. Omitted on the last page or when using offset.
Total matching transactions. Present only when offset is supplied.
Present only when earned_points=true. Points earned per day for the current page.
Show child attributes
Show child attributes