List transactions

Returns transactions ordered by date descending, then id.

This is a statement of an account: one row per movement, as the account recorded it. Every movement is returned, including the two legs of a transfer between the workspace’s own accounts and transactions the user has excluded from cash flow. Neither is marked, because neither changes what happened on the account.

Pending bank transactions are returned with status: pending. Duplicates detected by ThinkOut are never returned and cannot be requested.

Where a transaction has been split inside ThinkOut, the original movement is returned and its pieces are not. Reports count differently; see /transactions/summary.

GET

transactions

List transactions

curl --request GET \
  --url https://api.thinkout.io/v1/transactions \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.thinkout.io/v1/transactions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "object": "list",
  "data": [
    {
      "object": "transaction",
      "id": "8f1c0a4e-2b1d-4c8e-9f3a-7d6e5c4b3a21",
      "date": "2026-09-03",
      "amount": "-1250.00",
      "currency": "RON",
      "direction": "outflow",
      "status": "booked",
      "source": "bank",
      "description": "ORANGE ROMANIA SA",
      "comment": null,
      "account": "c2d7e8f9-1a2b-4c3d-8e9f-0a1b2c3d4e5f",
      "category": "3b4c5d6e-7f80-4a1b-9c2d-3e4f5a6b7c8d",
      "counterparty": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",
      "labels": [
        "1f2e3d4c-5b6a-4978-8877-665544332211"
      ],
      "bank_details": {
        "payer": "THINKOUT SRL",
        "payer_details": "RO49INGB0000999900000001",
        "payee": "ORANGE ROMANIA SA",
        "payee_details": "RO12BTRL0000000000000002",
        "reference": "Factura 2026-08 nr 1234567",
        "additional": null
      },
      "created_at": "2026-09-03T08:12:44Z",
      "updated_at": "2026-09-03T08:12:44Z"
    }
  ],
  "has_more": true,
  "next_cursor": "<string>"
}

{
  "error": {
    "type": "invalid_request",
    "code": "invalid_parameter",
    "message": "Parameter 'from' must be a date in YYYY-MM-DD format.",
    "param": "from",
    "request_id": "req_01J8ZT4Q7Y6M3K"
  }
}

{
  "error": {
    "type": "authentication",
    "code": "unauthorized",
    "message": "Invalid API key.",
    "param": null,
    "request_id": "req_01J8ZT4Q7Y6M3K"
  }
}

{
  "error": {
    "type": "rate_limit",
    "code": "rate_limited",
    "message": "Rate limit exceeded. Retry after 12 seconds.",
    "param": null,
    "request_id": "req_01J8ZT4Q7Y6M3K"
  }
}

Authorizations

Authorization

string

header

required

A workspace API key created in ThinkOut settings. One key reads one workspace.

Query Parameters

from

string<date>

Earliest date to include, inclusive. Ignored when period is given.

string<date>

Latest date to include, inclusive. Ignored when period is given.

bank_id

string<uuid>[]

Only rows on the accounts fed by these bank connections. Comma-separated for several.

account_id

string<uuid>[]

Only rows on these accounts. Comma-separated for several.

category_id

string<uuid>[]

Only rows in these categories. Comma-separated for several. On transactions this also matches a split transaction whose pieces are in one of them, even though the row itself carries no category.

label_id

string<uuid>[]

Only rows carrying at least one of these labels. Comma-separated for several.

counterparty_id

string<uuid>[]

Only rows attributed to these counterparties. Comma-separated for several.

direction

enum<string>

Whether money comes in or goes out.

On a transaction or a forecast it follows the sign of amount and can never disagree with it. It is present so that responses can be grouped and read without inspecting signs.

Available options:

inflow,

outflow

status

enum<string>

pending transactions come from a bank and are not yet booked. A pending amount can change when it books, and updated_at moves when it does, so upsert by id rather than treating a pending row as final.

Available options:

booked,

pending

expand

enum<string>[]

Relations to return as full objects instead of ids. Comma-separated.

Without it every relation is an id. Naming one here replaces the id with the object it points at. Expansion goes one level deep; an unsupported name is rejected.

Supported here: account, category, counterparty, labels.

Available options:

account,

category,

counterparty,

labels

limit

integer

default:100

Page size.

Required range: 1 <= x <= 500

cursor

string

Opaque token from the previous page's next_cursor.

Response

A page of transactions.

object

string

required

Allowed value: "list"

data

object[]

required

Show child attributes

has_more

boolean

required

Whether another page exists.

next_cursor

string | null

required

Pass as cursor to fetch the next page. null on the last page.

⌘I

List transactions

curl --request GET \
  --url https://api.thinkout.io/v1/transactions \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.thinkout.io/v1/transactions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "object": "list",
  "data": [
    {
      "object": "transaction",
      "id": "8f1c0a4e-2b1d-4c8e-9f3a-7d6e5c4b3a21",
      "date": "2026-09-03",
      "amount": "-1250.00",
      "currency": "RON",
      "direction": "outflow",
      "status": "booked",
      "source": "bank",
      "description": "ORANGE ROMANIA SA",
      "comment": null,
      "account": "c2d7e8f9-1a2b-4c3d-8e9f-0a1b2c3d4e5f",
      "category": "3b4c5d6e-7f80-4a1b-9c2d-3e4f5a6b7c8d",
      "counterparty": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",
      "labels": [
        "1f2e3d4c-5b6a-4978-8877-665544332211"
      ],
      "bank_details": {
        "payer": "THINKOUT SRL",
        "payer_details": "RO49INGB0000999900000001",
        "payee": "ORANGE ROMANIA SA",
        "payee_details": "RO12BTRL0000000000000002",
        "reference": "Factura 2026-08 nr 1234567",
        "additional": null
      },
      "created_at": "2026-09-03T08:12:44Z",
      "updated_at": "2026-09-03T08:12:44Z"
    }
  ],
  "has_more": true,
  "next_cursor": "<string>"
}

{
  "error": {
    "type": "invalid_request",
    "code": "invalid_parameter",
    "message": "Parameter 'from' must be a date in YYYY-MM-DD format.",
    "param": "from",
    "request_id": "req_01J8ZT4Q7Y6M3K"
  }
}

{
  "error": {
    "type": "authentication",
    "code": "unauthorized",
    "message": "Invalid API key.",
    "param": null,
    "request_id": "req_01J8ZT4Q7Y6M3K"
  }
}

{
  "error": {
    "type": "rate_limit",
    "code": "rate_limited",
    "message": "Rate limit exceeded. Retry after 12 seconds.",
    "param": null,
    "request_id": "req_01J8ZT4Q7Y6M3K"
  }
}

Getting started

Working with data

MCP

API reference

List transactions

Authorizations

Query Parameters

Response