{
  "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"
}

TRANSACTIONS

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.

GET

developer

transactions

{
  "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

Authorization

string

header

required

Short-lived access token. Obtain with your api_key.

Query Parameters

account_ids

string

Comma-separated account UUIDs to include.

account_currencies

string

Comma-separated ISO 4217 account currencies (for example GBP,EUR).

transaction_currencies

string

Comma-separated ISO 4217 currencies the transaction was made in.

ids

string

Comma-separated transaction UUIDs. Explicit lookups bypass the default type and scheduled exclusions.

source_payment_ids

string

Comma-separated identifiers of the payment in the originating source system.

status

string

Comma-separated statuses. One or more of pending, completed, declined, reversed.

type

string

Comma-separated transaction types. See the type field on the transaction object for values.

direction

string

Comma-separated directions. One or both of debit, credit.

user_ids

string

Comma-separated UUIDs of the users who initiated the transactions.

payee_ids

string

Comma-separated payee identifiers.

card_tokens

string

Comma-separated card tokens. Returns card transactions made with those cards.

category_ids

string

Comma-separated category UUIDs.

categorized

boolean

true returns only categorised transactions, false only uncategorised.

string

Case-insensitive substring match against name and reference.

from

string<date-time>

Inclusive lower bound on transaction_at (RFC 3339).

string<date-time>

Inclusive upper bound on transaction_at (RFC 3339). Must not be before from.

account_amount_min

string

Minimum absolute account amount (decimal string).

account_amount_max

string

Maximum absolute account amount (decimal string). Must not be less than account_amount_min.

scheduled

boolean

true returns only payments scheduled for today or later. false (default) excludes them.

earned_points

boolean

true returns only transactions that earned points and adds points_totals_by_day to the response.

sort

enum<string>

Sort field. Defaults to transaction_at.

Available options:

transaction_at,

completed_at,

authorized_at,

created_at

order

enum<string>

Sort order. Defaults to desc.

Available options:

asc,

desc

limit

integer

default:50

Page size, 1–200. Defaults to 50.

Required range: 1 <= x <= 200

cursor

string

Opaque next_cursor value from a previous page. Cannot be combined with offset.

offset

integer

Number of rows to skip. Enables the total count. Cannot be combined with cursor.

Required range: x >= 0

user

boolean

true includes a user object (name and avatar) on each transaction that has a user_id.

card

boolean

true includes a card object (name, last four digits, type) on each card transaction.

Response

One page of transactions.

transactions

Transaction · object[]

required

Transactions for the current page.

Show child attributes

next_cursor

string

Opaque cursor for the next page. Omitted on the last page or when using offset.

total

integer

Total matching transactions. Present only when offset is supplied.

points_totals_by_day

object[]

Present only when earned_points=true. Points earned per day for the current page.

Show child attributes

INVOICES

ACCOUNTS

CARDS

TRANSACTIONS

List transactions

Authorizations

Query Parameters

Response