---
title: "Read an accountant-only company brief"
method: GET
path: "/companies/{companyId}/brief"
tags: ["Company brief"]
---

# Read an accountant-only company brief

`GET /companies/{companyId}/brief`

## Request

- Base URL: `https://ledgerhq.pro/api/v1`
- URL: `https://ledgerhq.pro/api/v1/companies/{companyId}/brief`
- Auth: one of:
  - HTTP bearer and API key in header `x-organization-id`
  - HTTP bearer and API key in header `x-organization-id`

Returns the standard question catalog and current answer/defer/not-applicable state for one firm-managed company. Client-portal-only users cannot read this resource.

## Path parameters

- `companyId` string, uuid, required

## Response `200`

Company brief

- CompanyBrief
  - `company` object, required
    - `id` string, uuid, required
    - `name` string, required
  - `sections` CompanyBriefSection[], required
    - `id` string, uuid, nullable
    - `sectionKey` string, required
    - `title` string, required
    - `question` string, nullable
    - `guidance` string, nullable
    - `isStandard` boolean, required
    - `status` 'unasked' | 'answered' | 'deferred' | 'not_applicable', required
    - `content` string, nullable
    - `source` 'accountant' | 'tally_interview' | 'document' | 'null', nullable
    - `lastEditedSource` 'accountant' | 'tally_interview' | 'document' | 'null', nullable
    - `updatedByUserId` string, uuid, nullable
    - `lastAskedAt` string, date-time, nullable
    - `deferredUntil` string, date, nullable
    - `manualOnly` boolean, required
    - `createdAt` string, date-time, nullable
    - `updatedAt` string, date-time, nullable
  - `questionState` object, required
    - `answered` string[]
    - `deferred` string[]
    - `deferredEligibleAgain` string[]: Deferred questions whose quiet period has elapsed; they may be re-raised once.
    - `manualOnlyDeferred` string[]
    - `notApplicable` string[]
    - `unasked` string[]

## Other responses

- `default`: Error response

---

[API](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api.md) · [All operations](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api/revisions/9a8269f0a586?raw)