---
title: "Query GL entries"
method: POST
path: "/v6/accounting/glAccounts/{id}/generalLedger"
tags: ["GL Entries"]
---

# Query GL entries

`POST /v6/accounting/glAccounts/{id}/generalLedger`

Query GL entries for the authenticated user

## Path parameters

- `id` string, required

## Request body

- GlEntriesGetParam
  - `cursor` string, nullable — Cursor from the previous paginated response
  - `limit` integer — Page size, i.e. number of items to return per page
  - `filter` GlEntriesFilterParam — Filter for items in the response.
    - `includeBeginningBalance` boolean — Whether to include the beginning balance in the response.
    - `beginDate` string, date — Start date (inclusive). Defaults to Jan 1 of current year.
    - `endDate` string, date — End date (inclusive). Defaults to Dec 31 of current year.
    - `search` string — Search filter applied to GL entry descriptions.
    - `dimensionValues` DimensionValueFiltering[]
      - `dimensionId` string — Dimension ID to filter by
      - `dimensionValueIds` string[] — List of dimension value IDs under dimensionId to filter by
  - `accountingMethod` 'ACCRUAL' | 'CASH' — Accounting method to generate the report in. Defaults to the company's configured accounting method.

## Response `200`

Success

- GlEntryQueryResponse
  - `result` 'SUCCESS' | 'FAILURE' — The result of the action performed.
  - `data` GlEntryGetDto[] — The data generated by the action performed.
    - `id` string, required — Id of the GL entry
    - `entity` EntityExpanded, nullable, required — Entity reference
      - `id` string, required — Id of the entity
      - `description` string, nullable — Description of the entity
      - `displayName` string, nullable — Display name of the entity
      - `secondaryDisplayName` string, nullable — Secondary display name for the entity
      - `glAccount` GlAccountExpanded — GL account details
        - `id` string, required — Id of the GL account
        - `name` string — Name of the GL account
        - `accountNo` string — Number of the GL account
        - `type` 'ASSET' | 'LIABILITY' | 'EQUITY' | 'INCOME' | 'COGS' | 'EXPENSE' | 'OTHER_INCOME' | 'OTHER_EXPENSE' | 'SUSPENSE' — Type the GL account
        - `iconUrl` string — Icon URL of the GL account
        - `displayName` string — Display name of the GL account
    - `description` string, nullable, required — Description of the GL entry
    - `date` string, date, required — Date of the GL entry
    - `runningBalance` integer, nullable, required — Running balance of the General Ledger
    - `glAccount` ExpandedDataDefault, required — GL account associated with this entry
      - `id` string
    - `drAmount` integer, nullable, required — Debit amount in cents
    - `crAmount` integer, nullable, required — Credit amount in cents
    - `type` 'EXPENSE' | 'REVENUE' | 'TRANSFER_IN' | 'TRANSFER_OUT' | 'INVOICE' | 'BILL' | 'PAYROLL' | 'JOURNAL_ENTRY' — Transaction type derived from the GL source. When a bank transaction type is present, one of the PublicType values is returned. Otherwise falls back to the GL source name.
  - `cursor` ResponseCursor — Cursor to be used in your subsequent paginated request. Only populated if there are more pages available.
    - `after` string — After cursor - Fetches entities after this cursor. Useful for paging forwards.
    - `before` string — Before cursor - Fetches entities before this cursor. Useful for paging backwards.
  - `beginningBalance` integer — Beginning balance in cents. Present on the first page when applicable; null on subsequent pages.

## Other responses

- `400` — Bad request
- `401` — Not authenticated
- `403` — Not authorized
- `404` — Endpoint not found
- `500` — Internal server error

---

[API](https://skmtc.net/tight/apis/tight-api.md) · [All operations](https://skmtc.net/tight/apis/tight-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tight/tight-api/revisions/e9f0790a89af/schema)