> ## Documentation Index
> Fetch the complete documentation index at: https://docs.equated.co/llms.txt
> Use this file to discover all available pages before exploring further.

# List posted journal entries

> Chronological feed of POSTED entries with full postings and origins — the same entry shape as the general-ledger report, with the bank-feed scoping that report lacks (`financialAccountIds`, `hasCashLeg`). `source` filters the same way there (e.g. `MANUAL` to find standalone entries eligible for `void_journal_entry`, or `OPENING`/`ACCRUAL`/`SYSTEM`). Paged with `limit`/`offset` against `total`.



## OpenAPI

````yaml /openapi.json get /api/journal-entries
openapi: 3.1.0
info:
  title: Equated API
  version: 1.0.0
  description: >-
    Agent-facing accounting API. Authenticate with a bearer token issued from
    Settings → API Tokens, or via the in-app session cookie when called from the
    web client.
servers:
  - url: https://app.equated.co
    description: API server
security: []
paths:
  /api/journal-entries:
    get:
      tags:
        - Journal Entries
      summary: List posted journal entries
      description: >-
        Chronological feed of POSTED entries with full postings and origins —
        the same entry shape as the general-ledger report, with the bank-feed
        scoping that report lacks (`financialAccountIds`, `hasCashLeg`).
        `source` filters the same way there (e.g. `MANUAL` to find standalone
        entries eligible for `void_journal_entry`, or
        `OPENING`/`ACCRUAL`/`SYSTEM`). Paged with `limit`/`offset` against
        `total`.
      parameters:
        - schema:
            type: string
            pattern: ^\d{4}-\d{2}-\d{2}$
          required: false
          name: from
          in: query
        - schema:
            type: string
            pattern: ^\d{4}-\d{2}-\d{2}$
          required: false
          name: to
          in: query
        - schema:
            type: integer
            minimum: 0
            exclusiveMinimum: true
            description: Scope to entries touching one ledger account.
          required: false
          description: Scope to entries touching one ledger account.
          name: accountId
          in: query
        - schema:
            type: string
            description: >-
              Comma-separated bank-feed account ids; scopes to entries touching
              those feeds' ledger accounts.
          required: false
          description: >-
            Comma-separated bank-feed account ids; scopes to entries touching
            those feeds' ledger accounts.
          name: financialAccountIds
          in: query
        - schema:
            type: string
            enum:
              - 'true'
              - 'false'
            description: >-
              `true` returns only entries with a posting on a bank-backed ledger
              account.
          required: false
          description: >-
            `true` returns only entries with a posting on a bank-backed ledger
            account.
          name: hasCashLeg
          in: query
        - schema:
            type: string
            description: >-
              Comma-separated entry sources to include: BANK_FEED, MANUAL,
              ACCRUAL, SYSTEM, INTEGRATION, OPENING, RECONCILIATION. Defaults to
              every source.
          required: false
          description: >-
            Comma-separated entry sources to include: BANK_FEED, MANUAL,
            ACCRUAL, SYSTEM, INTEGRATION, OPENING, RECONCILIATION. Defaults to
            every source.
          name: source
          in: query
        - schema:
            type: integer
            minimum: 0
            exclusiveMinimum: true
            maximum: 500
          required: false
          name: limit
          in: query
        - schema:
            type: integer
            nullable: true
            minimum: 0
          required: false
          name: offset
          in: query
      responses:
        '200':
          description: The matching posted entries
          content:
            application/json:
              schema:
                type: object
                properties:
                  entries:
                    type: array
                    items:
                      $ref: '#/components/schemas/GeneralLedgerEntry'
                  total:
                    type: number
                required:
                  - entries
                  - total
      security:
        - bearerAuth: []
components:
  schemas:
    GeneralLedgerEntry:
      type: object
      properties:
        id:
          type: number
        effectiveAt:
          type: string
        description:
          type: string
          nullable: true
        status:
          type: string
          enum:
            - DRAFT
            - POSTED
            - VOID
        source:
          type: string
          nullable: true
        baseCurrency:
          type: string
        correctsJournalEntryId:
          type: number
          nullable: true
        postings:
          type: array
          items:
            type: object
            properties:
              accountId:
                type: number
              accountName:
                type: string
              accountType:
                type: string
                enum:
                  - ASSET
                  - LIABILITY
                  - EQUITY
                  - INCOME
                  - EXPENSE
              accountEmoji:
                type: string
                nullable: true
              institutionLogo:
                type: string
                nullable: true
              institutionName:
                type: string
                nullable: true
              institutionUrl:
                type: string
                nullable: true
              amount:
                type: string
                description: Signed amount in the posting currency (debit positive).
              currency:
                type: string
              amountBase:
                type: string
              isBankLeg:
                type: boolean
              orgMerchantId:
                type: number
                nullable: true
              projectId:
                type: number
                nullable: true
                description: >-
                  The project this line counts toward. Only income and expense
                  lines carry one, and a project scope counts only lines on it.
              inScope:
                type: boolean
                description: >-
                  On a project-scoped ledger: whether this line counts toward
                  the scope.
              requiresCounterparty:
                type: boolean
            required:
              - accountId
              - accountName
              - accountType
              - accountEmoji
              - institutionLogo
              - institutionName
              - institutionUrl
              - amount
              - currency
              - amountBase
              - isBankLeg
        origin:
          type: object
          properties:
            kind:
              type: string
              enum:
                - transaction
                - bill
                - invoice
                - receipt
                - reimbursement
                - integration
                - manual
                - system
                - unknown
            label:
              type: string
            providerTransactionId:
              type: string
            documentId:
              type: number
            documentType:
              type: string
          required:
            - kind
            - label
        counterparty:
          type: object
          nullable: true
          properties:
            orgMerchantId:
              type: number
            name:
              type: string
            website:
              type: string
              nullable: true
            imageUrl:
              type: string
              nullable: true
            logo:
              type: string
              nullable: true
          required:
            - orgMerchantId
            - name
            - website
            - imageUrl
            - logo
          description: Who the money moved to or from, when the entry attributes one.
        canVoid:
          type: boolean
      required:
        - id
        - effectiveAt
        - description
        - status
        - source
        - baseCurrency
        - correctsJournalEntryId
        - postings
        - origin
        - counterparty
        - canVoid
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API token issued from the Equated app under Settings → API Tokens.

````