---
title: "General ledger (recent posted journal entries)"
method: GET
path: "/companies/{companyId}/reports/general-ledger"
tags: ["Reports"]
---

# General ledger (recent posted journal entries)

`GET /companies/{companyId}/reports/general-ledger`

## Request

- Base URL: `https://api.medianfi.com/api/v1`
- URL: `https://api.medianfi.com/api/v1/companies/{companyId}/reports/general-ledger`
- Auth: HTTP bearer

## Query parameters

- `entityId` string, uuid
- `reportingScopeId` string, uuid
- `scopeAsOf` string, date
- `startDate` string, date
- `endDate` string, date
- `allTime` 'true'
- `classId` string
- `limit` integer
- `cursor` string

## Response `200`

General ledger payload

- object
  - `success` boolean
  - `data` object
    - `ledgerRevision` string, nullable: Opaque token of the posted ledger state the report was read under (#1166). It changes whenever any journal entry or line of the company (with `entityId`, of that entity and of entries with no entity) is inserted, updated, voided or deleted, backdated or not. Two reads with equal tokens saw the same ledger. Null when the ledger moved on both attempts of the read, so a client combining pages or statements must treat the result as unproven and retry. Not a credential; not ordered.
    - `currency` string, nullable, required
    - `minorUnitExponent` 2 | null, nullable, required
    - `items` object[], required
    - `nextCursor` string, nullable, required
    - `hasMore` boolean, required

## Other responses

- `401`: Authentication required
- `422`: Explicit financial scope is required, or the resolved consolidated report is not yet available

---

[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)