> ## Documentation Index > Fetch the complete documentation index at: https://developers.thinkout.io/llms.txt > Use this file to discover all available pages before exploring further. # List accounts > Returns every account in the workspace, ordered by `name`, then `id`. This list is not paged. A workspace holds few enough accounts to return in one call, so there is no `limit` and no `cursor`, and `has_more` is always `false`. The envelope is the same as every other list so that client code does not have to special-case it. Balances are computed as of today in UTC. For a balance on another day use `GET /accounts/{id}` with `as_of`, or `GET /balances` for every account at once. ## OpenAPI ````yaml /openapi/v1.yaml get /accounts openapi: 3.1.0 info: title: ThinkOut API version: '1.0' description: > Programmatic access to the data of a ThinkOut workspace. Every endpoint in version 1 is a `GET`. Lists share one response envelope, and page with a cursor wherever the list can grow. Version 1 changes additively. New endpoints, new optional parameters, new response fields and new enum values can appear at any time, so tolerate unknown fields and never treat an enum as a closed set. contact: name: ThinkOut developer support url: https://developers.thinkout.io/guides/support servers: - url: https://api.thinkout.io/v1 security: - apiKey: [] tags: - name: Banks description: The workspace's bank connections and the state of each one. - name: Accounts description: Manual, bank-synced and delegated accounts with computed balances. - name: Transactions description: Booked and pending movements on the workspace's accounts. - name: Categories description: The workspace category tree, split by direction and business activity. - name: Counterparties description: Customers and suppliers that transactions and forecasts are attributed to. - name: Labels description: Free-form tags grouped by label type. - name: Forecasts description: Planned inflows and outflows and the transactions that realised them. - name: Reports description: >- Totals rather than rows. Summaries over transactions and forecasts, and the workspace's own saved cash flow views. paths: /accounts: get: tags: - Accounts summary: List accounts description: > Returns every account in the workspace, ordered by `name`, then `id`. This list is not paged. A workspace holds few enough accounts to return in one call, so there is no `limit` and no `cursor`, and `has_more` is always `false`. The envelope is the same as every other list so that client code does not have to special-case it. Balances are computed as of today in UTC. For a balance on another day use `GET /accounts/{id}` with `as_of`, or `GET /balances` for every account at once. operationId: listAccounts parameters: - name: bank_id in: query description: >- Only accounts fed by these bank connections. Comma-separated for several. style: form explode: false schema: type: array items: type: string format: uuid - $ref: '#/components/parameters/account_expand' responses: '200': description: Every account in the workspace. content: application/json: schema: allOf: - $ref: '#/components/schemas/List' - type: object properties: data: type: array items: $ref: '#/components/schemas/Account' has_more: type: boolean const: false description: Always `false`. This list is not paged. next_cursor: type: 'null' description: Always `null`. This list is not paged. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '429': $ref: '#/components/responses/RateLimited' components: parameters: account_expand: name: expand in: query description: > 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`. style: form explode: false schema: type: array items: type: string enum: - bank example: bank schemas: List: type: object required: - object - data - has_more - next_cursor properties: object: type: string const: list data: type: array items: {} has_more: type: boolean description: Whether another page exists. next_cursor: type: - string - 'null' description: Pass as `cursor` to fetch the next page. `null` on the last page. Account: type: object required: - object - id - name - currency - group - source - balance - balance_as_of - opening_balance - opening_date - bank - external_account_id - original_name - created_at - updated_at properties: object: type: string const: account id: type: string format: uuid name: type: string example: ING Curent currency: $ref: '#/components/schemas/Currency' group: type: - string - 'null' description: Free-text grouping assigned in ThinkOut. example: Operational source: $ref: '#/components/schemas/AccountSource' balance: $ref: '#/components/schemas/Money' balance_as_of: type: string format: date description: >- The day whose end-of-day balance is reported. Computed at request time. opening_balance: $ref: '#/components/schemas/Money' opening_date: type: string format: date description: >- The date the opening balance applies to. Transactions before it are not expected. bank: $ref: '#/components/schemas/ExpandableBank' external_account_id: type: - string - 'null' description: >- The account identifier at the provider, useful for reconciliation. `null` for manual accounts. original_name: type: - string - 'null' description: >- The account name as the bank reports it, before any rename in ThinkOut. `null` for manual accounts. created_at: type: string format: date-time updated_at: type: string format: date-time example: 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' Currency: type: string description: ISO 4217 alphabetic currency code. pattern: ^[A-Z]{3}$ example: RON AccountSource: type: string description: >- `delegated` accounts are bank accounts another workspace has delegated to this one. enum: - manual - bank - delegated Money: type: string description: > 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' ExpandableBank: description: >- A bank connection id, the full connection when named in `expand`, or `null` for a manual account. oneOf: - type: string format: uuid - $ref: '#/components/schemas/Bank' - type: 'null' Error: type: object required: - error properties: error: type: object required: - type - code - message - param - request_id properties: type: type: string enum: - invalid_request - authentication - not_found - rate_limit - server code: type: string description: > Stable machine-readable reason. Branch on this, not on `message`. Report-specific codes are `too_many_groups`, `period_too_long`, `as_of_in_future` and `invalid_expand`. message: type: string description: Human-readable explanation. Wording may change. param: type: - string - 'null' description: The query or path parameter at fault, when there is one. request_id: type: string description: Quote this when contacting support. Bank: type: object description: > One authorisation with one bank. Several accounts can share a connection, and a workspace can hold several connections to the same bank. required: - object - id - name - country_code - status - last_sync_at - consent_expires_at - created_at - updated_at properties: object: type: string const: bank id: type: string format: uuid name: type: string description: The bank's name as the provider reports it. example: ING Bank country_code: type: - string - 'null' description: ISO 3166-1 alpha-2 country of the bank. pattern: ^[A-Z]{2}$ example: RO status: $ref: '#/components/schemas/BankStatus' last_sync_at: type: - string - 'null' format: date-time description: > When the provider last returned data successfully. `null` when it never has. This is the age of the data, not the age of the connection. A connection can sit at `connected` with a `last_sync_at` days old, which is the case worth alerting on. consent_expires_at: type: - string - 'null' format: date-time description: > When the bank consent needs renewal, if the provider reports it. Once it passes, the connection stops returning new transactions until someone re-approves it. created_at: type: string format: date-time description: When the connection was first authorised. updated_at: type: string format: date-time example: object: bank id: 5d6e7f80-9a1b-4c2d-8e3f-4a5b6c7d8e9f name: ING Bank country_code: RO status: connected last_sync_at: '2026-09-03T06:00:00Z' consent_expires_at: '2026-11-30T00:00:00Z' created_at: '2024-01-01T10:00:00Z' updated_at: '2026-09-03T06:00:00Z' BankStatus: type: string description: > The state of the connection as of ThinkOut's last exchange with the provider. `connected` is working. `loading` is a sync in progress. `requires_action` needs a person to sign in or re-approve the connection in ThinkOut, and no new transactions arrive until they do. `error` is a failure ThinkOut could not resolve on its own, and covers any provider state ThinkOut cannot place. Only `connected` means the data behind it is current. enum: - connected - loading - requires_action - error responses: BadRequest: description: A parameter is invalid. content: application/json: schema: $ref: '#/components/schemas/Error' example: 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 Unauthorized: description: The API key is missing, unknown or revoked. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: type: authentication code: unauthorized message: Invalid API key. param: null request_id: req_01J8ZT4Q7Y6M3K RateLimited: description: Too many requests. Wait for the number of seconds in `Retry-After`. headers: Retry-After: schema: type: integer description: Seconds to wait before retrying. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: type: rate_limit code: rate_limited message: Rate limit exceeded. Retry after 12 seconds. param: null request_id: req_01J8ZT4Q7Y6M3K securitySchemes: apiKey: type: http scheme: bearer description: >- A workspace API key created in ThinkOut settings. One key reads one workspace. ````