---
title: "List accounting accounts"
method: GET
path: "/accountingaccounts/{companyId}"
tags: ["AccountingAccounts"]
---

# List accounting accounts

`GET /accountingaccounts/{companyId}`

Returns the accounting accounts (chart of accounts) of a company, including deactivated ones. Results are paginated: use `limit` to control page size and pass the returned `nextPageToken` to fetch the next page.

## Path parameters

- `companyId` string, required

## Query parameters

- `limit` integer — Maximum number of objects to return in the response. Default 500, maximum 2000.
- `nextPageToken` string — Token to fetch the next page of results, taken from the `nextPageToken` returned by the previous request with the same filters. Omit it to fetch the first page. An invalid or malformed token is rejected with `404`.

## Response `200`

Successful Response

- ListAccountingsAccountsResponseSchema
  - `data` GetAccountingsAccountsResponseSchema[], required — Accounting accounts matching the query.
    - `active` boolean, nullable — Whether the accounting account is active.
    - `type` 'banks' | 'analytics' | 'accountings'
    - `accountingName` string, nullable — Display name of the accounting account. Defaults to `accountingCode` when omitted.
    - `collective` boolean, nullable — Whether this is a collective (grouping) accounting account rather than an individual one.
    - `additionalInfo` object, nullable — Free-form key/value metadata to attach to the account. Sending an empty object leaves any previously stored metadata unchanged instead of clearing it.
    - `attributes` AttributeValueRequestACCOUNTSchema[], nullable — Custom attribute values to attach to the account. Entries with an empty or missing `customId` or `value` are silently discarded.
      - `customId` string, nullable — Custom ID of the attribute definition this value belongs to. Entries missing `customId` or `value` are silently discarded.
      - `value` string, nullable — Value assigned to the attribute.
      - `valueCustomId` string, nullable — Custom ID of the selected option, for list-type attributes.
    - `accountingCode` string, required — Unique code identifying the accounting account in the company's chart of accounts.
    - `companyId` string, required — Embat company ID. You can get them from "companies" endpoints
    - `updatedAt` string, date-time, required — Last updated date of the entity in the database
    - `createdAt` string, date-time, required — Created date of the entity in the database
    - `balance` number, nullable — Current balance of the accounting account.
    - `balanceDate` string, date-time, nullable — Date the balance was last calculated.
  - `nextPageToken` string, nullable — Token to fetch the next page of results. `null` when there are no more pages.

## Other responses

- `401` — Unauthorized. The bearer token is missing, invalid or expired.
- `404` — Company not found, or invalid `nextPageToken`.
- `422` — Validation Error

---

[API](https://skmtc.net/embat/apis/embat-api.md) · [All operations](https://skmtc.net/embat/apis/embat-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/embat/embat-api/versions/36ca48bf4489/schema)