Get a transaction

GET

transactions

{id}

Get a transaction

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

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

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

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

{
  "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": "not_found",
    "code": "resource_not_found",
    "message": "No transaction with id 8f1c0a4e-2b1d-4c8e-9f3a-7d6e5c4b3a21.",
    "param": "id",
    "request_id": "req_01J8ZT4Q7Y6M3K"
  }
}

Authorizations

Authorization

string

header

required

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

Path Parameters

string<uuid>

required

Query Parameters

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

Response

The transaction.

object

string

required

Allowed value: "transaction"

string<uuid>

required

date

string<date>

required

Booking date. There is no time component.

Example:

"2026-09-03"

amount

string

required

Decimal amount as a string. Signed on transactions, forecasts and report figures, where negative means an outflow. The sign is authoritative: direction is derived from it and the two can never disagree.

Pattern: ^-?[0-9]+(\.[0-9]+)?$

Example:

"-1250.00"

currency

string

required

ISO 4217 alphabetic currency code.

Pattern: ^[A-Z]{3}$

Example:

"RON"

direction

enum<string>

required

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>

required

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

source

enum<string>

required

How the transaction entered ThinkOut.

Available options:

manual,

import,

bank

description

string | null

required

Example:

"ORANGE ROMANIA SA"

comment

string | null

required

Free text added by users in ThinkOut.

account

required

An account id, or the full account when named in expand.

category

required

null when the transaction has no category. That includes every transaction split inside ThinkOut, where categorisation moved to the pieces and the pieces are not exposed by this API.

counterparty

required

A counterparty id, the full counterparty when named in expand, or null when unattributed.

labels

(string<uuid> | object)[]

required

Label ids, or the full labels when labels is named in expand.

bank_details

object | null

required

Raw fields received from the bank. Present only on source: bank transactions.

Show child attributes

created_at

string<date-time>

required

updated_at

string<date-time>

required

⌘I

Get a transaction

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

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

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

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

{
  "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": "not_found",
    "code": "resource_not_found",
    "message": "No transaction with id 8f1c0a4e-2b1d-4c8e-9f3a-7d6e5c4b3a21.",
    "param": "id",
    "request_id": "req_01J8ZT4Q7Y6M3K"
  }
}

Getting started

Working with data

MCP

API reference

Authorizations

Path Parameters

Query Parameters

Response