List transactions

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));

using RestSharp;


var options = new RestClientOptions("https://api.thinkout.io/v1/transactions");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
var response = await client.GetAsync(request);

Console.WriteLine("{0}", response.Content);

{
  "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": "direction must be 'inflow' or 'outflow'",
    "param": "direction",
    "request_id": "0HNF8K3QJL2VM:00000001"
  }
}

{
  "error": {
    "type": "authentication",
    "code": "unauthorized",
    "message": "Missing, malformed, unknown or revoked API key",
    "param": null,
    "request_id": "0HNF8K3QJL2VM:00000001"
  }
}

{
  "error": {
    "type": "authentication",
    "code": "forbidden",
    "message": "The API is not included in this company's ThinkOut plan. Contact support@thinkout.io to enable it.",
    "param": null,
    "request_id": "0HNF8K3QJL2VM:00000001"
  }
}

{
  "error": {
    "type": "rate_limit",
    "code": "rate_limited",
    "message": "Too many requests",
    "param": null,
    "request_id": "0HNF8K3QJL2VM:00000001"
  }
}

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.

string<date>

Latest date to include, inclusive.

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. Subcategories are included only on the summaries.

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 forecast it follows the sign of amount.

Available options:

inflow,

outflow

status

enum<string>

pending transactions come from a bank and are not yet booked. Their amount can change when they book, so upsert by id.

Available options:

booked,

pending

expand

enum<string>[]

Relations to return as objects instead of ids. Comma-separated. Expansion goes one level deep; an unknown name is rejected with invalid_expand.

Available options:

account,

category,

counterparty,

labels

limit

integer

default:100

Page size. Outside the range it is rejected with limit_out_of_range.

Required range: 1 <= x <= 500

cursor

string

Opaque token from the previous page's next_cursor. Keep the other parameters unchanged between pages.

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.

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));

using RestSharp;


var options = new RestClientOptions("https://api.thinkout.io/v1/transactions");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
var response = await client.GetAsync(request);

Console.WriteLine("{0}", response.Content);

{
  "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": "direction must be 'inflow' or 'outflow'",
    "param": "direction",
    "request_id": "0HNF8K3QJL2VM:00000001"
  }
}

{
  "error": {
    "type": "authentication",
    "code": "unauthorized",
    "message": "Missing, malformed, unknown or revoked API key",
    "param": null,
    "request_id": "0HNF8K3QJL2VM:00000001"
  }
}

{
  "error": {
    "type": "authentication",
    "code": "forbidden",
    "message": "The API is not included in this company's ThinkOut plan. Contact support@thinkout.io to enable it.",
    "param": null,
    "request_id": "0HNF8K3QJL2VM:00000001"
  }
}

{
  "error": {
    "type": "rate_limit",
    "code": "rate_limited",
    "message": "Too many requests",
    "param": null,
    "request_id": "0HNF8K3QJL2VM:00000001"
  }
}

Getting started

MCP

REST API

API reference

Authorizations

Query Parameters

Response