---
title: "Read chart of accounts"
method: GET
path: "/accountant/chart-of-accounts"
tags: ["Accountant Portal"]
---

# Read chart of accounts

`GET /accountant/chart-of-accounts`

## Request

- Base URL: `https://api.medianfi.com/api/v1`
- URL: `https://api.medianfi.com/api/v1/accountant/chart-of-accounts`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Generated minimal contract (#1940): parameters, auth, and status codes are authoritative; see the route handler for the exact row shape. `meta.truncated` is authoritative (#1959): true means an assigned customer's report-access lookup could not be evaluated and its accounts are missing from `data`.

## Response `200`

Success envelope; `meta.truncated` reports scope completeness

- object
  - `success` boolean
  - `data` object[]
  - `meta` AccountantScopeMeta: Completeness of a practice-wide accountant read (#1959).
    - `truncated` boolean: True when at least one assigned customer was dropped from this practice-wide read because its client-status / report-access lookup could not be evaluated, so the payload is short that customer's rows (#1959). A customer deliberately excluded by its client status is not a gap and does not raise this. Always false on the customer-scoped route, which never fans out.

## Other responses

- `401`: Authentication required
- `403`: Insufficient permissions or not a company member

---

[API](https://skmtc.dev/medianfi/apis/median-api.md) · [All operations](https://skmtc.dev/medianfi/apis/median-api/llms.txt) · [OpenAPI document](https://skmtc.dev/medianfi/apis/median-api/revisions/20090ea32b0d?raw)