Get an account

GET

accounts

{id}

Get an account

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

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

fetch('https://api.thinkout.io/v1/accounts/{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/accounts/{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": "account",
  "id": "c2d7e8f9-1a2b-4c3d-8e9f-0a1b2c3d4e5f",
  "name": "ING Curent",
  "currency": "RON",
  "group": "Operational",
  "source": "bank",
  "balance": "15230.45",
  "balance_as_of": "2026-09-03",
  "opening_balance": "1000.00",
  "opening_date": "2024-01-01",
  "bank": "5d6e7f80-9a1b-4c2d-8e3f-4a5b6c7d8e9f",
  "external_account_id": "ACC-00012345",
  "original_name": "Cont curent RON",
  "created_at": "2024-01-01T10:00:00Z",
  "updated_at": "2026-08-30T06:00:00Z"
}

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

as_of

string<date>

Compute balances at the end of this day. Defaults to today: the UTC day on /accounts/{id}, the workspace's local day on /balances. A future date is rejected with as_of_in_future.

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:

bank

Response

The account.

object

string

required

Allowed value: "account"

string<uuid>

required

name

string

required

Example:

"ING Curent"

currency

string

required

ISO 4217 alphabetic currency code.

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

Example:

"RON"

group

string | null

required

Free-text grouping assigned in ThinkOut.

Example:

"Operational"

source

enum<string>

required

delegated accounts are bank accounts another workspace has delegated to this one.

Available options:

manual,

bank,

delegated

balance

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"

balance_as_of

string<date>

required

The day whose end-of-day balance is reported.

opening_balance

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"

opening_date

string<date>

required

The date the opening balance applies to.

bank

required

A bank connection id, the full connection when named in expand, or null for a manual account. On a delegated account the connection belongs to another workspace, so the id is returned but is neither expanded nor readable.

external_account_id

string | null

required

The account identifier at the provider. null for manual accounts.

original_name

string | null

required

The account name as the bank reports it, before any rename in ThinkOut. null for manual accounts.

created_at

string<date-time>

required

updated_at

string<date-time>

required

Get an account

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

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

fetch('https://api.thinkout.io/v1/accounts/{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/accounts/{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": "account",
  "id": "c2d7e8f9-1a2b-4c3d-8e9f-0a1b2c3d4e5f",
  "name": "ING Curent",
  "currency": "RON",
  "group": "Operational",
  "source": "bank",
  "balance": "15230.45",
  "balance_as_of": "2026-09-03",
  "opening_balance": "1000.00",
  "opening_date": "2024-01-01",
  "bank": "5d6e7f80-9a1b-4c2d-8e3f-4a5b6c7d8e9f",
  "external_account_id": "ACC-00012345",
  "original_name": "Cont curent RON",
  "created_at": "2024-01-01T10:00:00Z",
  "updated_at": "2026-08-30T06:00:00Z"
}

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