Get an account - ThinkOut Developers

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

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

id

string<uuid>

required

Query Parameters

as_of

string<date>

Compute balances as of the end of this day. Defaults to today in UTC. A future date is rejected, because a balance is only ever historical.

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: bank.

Available options:

bank

Response

The account.

object

string

required

Allowed value: "account"

id

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

balance_as_of

string<date>

required

The day whose end-of-day balance is reported. Computed at request time.

opening_balance

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"

opening_date

string<date>

required

The date the opening balance applies to. Transactions before it are not expected.

bank

required

A bank connection id, the full connection when named in expand, or null for a manual account.

external_account_id

string | null

required

The account identifier at the provider, useful for reconciliation. 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

⌘I

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

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