---
title: "Retrieve accounting account"
method: GET
path: "/accountingaccounts/{companyId}/{accountingCode}"
tags: ["AccountingAccounts"]
---

# Retrieve accounting account

`GET /accountingaccounts/{companyId}/{accountingCode}`

Returns a single accounting account by `accountingCode`, including deactivated accounts.

## Path parameters

- `accountingCode` string, required
- `companyId` string, required

## Response `200`

Successful Response

- GetAccountingsAccountsResponseSchema
  - `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.

## Other responses

- `401` — Unauthorized. The bearer token is missing, invalid or expired.
- `404` — Company not found, or no accounting account matches the given `accountingCode`.
- `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/revisions/36ca48bf4489/schema)