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

using RestSharp;


var options = new RestClientOptions("https://api.thinkout.io/v1/transactions/{id}");
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": "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": "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": "not_found",
    "code": "resource_not_found",
    "message": "Transaction not found",
    "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.

Path Parameters

string<uuid>

required

Query Parameters

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

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 with two decimals. Negative means an outflow on transactions, forecasts and report figures.

Pattern: ^-?[0-9]+\.[0-9]{2}$

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

Available options:

inflow,

outflow

status

enum<string>

required

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

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 for a split transaction, whose categorisation lives on its pieces.

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

null unless source is bank.

Show child attributes

created_at

string<date-time>

required

updated_at

string<date-time>

required

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

using RestSharp;


var options = new RestClientOptions("https://api.thinkout.io/v1/transactions/{id}");
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": "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": "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": "not_found",
    "code": "resource_not_found",
    "message": "Transaction not found",
    "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

Path Parameters

Query Parameters

Response