> ## Documentation Index > Fetch the complete documentation index at: https://docs.trycherry.ai/llms.txt > Use this file to discover all available pages before exploring further. # Journal entries in a period > The double-entry journal between `from` and `to` (both required), oldest first, each entry with its balanced debit/credit lines. Add `accountNumber` to see only the entries touching one account — the drill-down behind any statement or trial-balance figure. ## OpenAPI ````yaml /openapi.json get /journal-entries openapi: 3.0.3 info: title: Cherry API version: 1.0.0 description: >- Cherry's public developer API — programmatic access to a business's books as Cherry keeps them: bank transactions with their categorizations, the chart of accounts, the double-entry journal, financial statements, legal entities, the tax-obligation calendar, and the fiscal health score. Authenticate every request with an API key: `Authorization: Bearer ck_live_…`. Keys are created in the Cherry app and are scoped to one business (tenant) — there is no tenant id in any URL. Keys carry a `read` and/or `write` scope; every GET needs `read`, mutations need `write`. Conventions: successful responses wrap the payload in `{ "data": … }`; list endpoints add `{ "meta": { "pagination": { limit, offset, nextOffset } } }` — pass `nextOffset` back as `offset` until it is null. Errors are `{ "error": string, "reason"?: string }` with conventional status codes. Dates are `YYYY-MM-DD`; money amounts are numbers in the row's currency. Requests are rate-limited per key with token buckets (429 + `Retry-After` when exhausted); report generation has a smaller budget than plain reads. servers: - url: https://api.trycherry.ai/v1 security: - bearerAuth: [] tags: - name: Transactions description: Bank feed rows and their categorizations. - name: Accounts description: The tenant's chart of accounts. - name: Bank accounts description: >- Connected bank accounts — Plaid-linked and manual. Manual institutions are how developers without a Plaid connection bring their own accounts and transactions. - name: Journal description: The double-entry journal (entries and lines). - name: Reports description: Trial balance and financial statements. - name: Entities description: Legal entities behind the tenant. - name: Obligations description: The tax/compliance calendar Cherry tracks. - name: Health description: Cherry's composite fiscal readiness score. - name: Meta description: The API's own machine-readable contract. paths: /journal-entries: get: tags: - Journal summary: Journal entries in a period description: >- The double-entry journal between `from` and `to` (both required), oldest first, each entry with its balanced debit/credit lines. Add `accountNumber` to see only the entries touching one account — the drill-down behind any statement or trial-balance figure. operationId: listJournalEntries parameters: - name: from in: query required: true description: Period start, YYYY-MM-DD. schema: type: string format: date - name: to in: query required: true description: Period end, YYYY-MM-DD. schema: type: string format: date - name: accountNumber in: query required: false description: Only entries with a line on this ledger account. schema: type: string - name: entityId in: query required: false description: >- Scope to one legal entity (UUID from GET /entities). Defaults to the tenant's primary entity. schema: type: string format: uuid - name: limit in: query required: false description: Page size, 1-200. Default 50. schema: type: integer minimum: 1 maximum: 200 default: 50 - name: offset in: query required: false description: >- Row offset. Pass the previous page's `meta.pagination.nextOffset` to fetch the next page; `nextOffset` is null once the last page is reached. schema: type: integer minimum: 0 default: 0 responses: '200': description: Journal entries, oldest first content: application/json: schema: type: object properties: data: type: array items: $ref: '#/components/schemas/JournalEntry' meta: type: object properties: pagination: $ref: '#/components/schemas/PaginationMeta' '400': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '401': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '429': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' components: schemas: JournalEntry: type: object description: >- One balanced double-entry posting. Lines debit and credit ledger accounts; debits equal credits within every entry. properties: id: type: string format: uuid entityId: type: string format: uuid entryDate: type: string format: date description: type: string sourceType: type: string description: What produced the entry (bank feed, invoice, manual, …). postedAt: type: string lines: type: array items: $ref: '#/components/schemas/JournalLine' PaginationMeta: type: object properties: limit: type: integer offset: type: integer nextOffset: type: integer nullable: true description: Offset for the next page, or null when this page was the last. Error: type: object required: - error properties: error: type: string description: Stable machine-readable error code. reason: type: string description: Human-readable explanation. JournalLine: type: object properties: accountId: type: string format: uuid description: Ledger account id — join against GET /accounts. debit: type: number nullable: true credit: type: number nullable: true currency: type: string memo: type: string nullable: true securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: ck_live_… description: >- Cherry API key, created in the app. Sent as `Authorization: Bearer ck_live_…`. ````