---
title: "Ledger Items"
method: POST
path: "/employer/ledger-items"
tags: ["Payroll"]
---

# Ledger Items

`POST /employer/ledger-items`

Read the ledger entries for one or more payments.

## Query parameters

- `entity_ids` string[]

## Headers

- `Finch-API-Version` string, date, required
- `Content-Type` string, required

## Request body

- object
  - `requests` object[], required — One entry per payment you want the ledger for.
    - `payment_id` string, uuid, required — A stable Finch `id` (UUID v4) for a payment.
    - `offset` integer — The number of `ledger_items` to skip for this payment.
    - `limit` integer — The maximum number of `ledger_items` to return for this payment.

## Response `200`

The ledger for each requested payment.

- GetLedgerItemsResponse
  - `responses` LedgerBatchItem[], required
    - `payment_id` string, required
    - `code` integer, required
    - `body` union, required
      - LedgerItemsData
        - `source` 'direct' | 'synthesized', required — `direct` when the provider supplies the ledger; `synthesized` when Finch computes it from pay statements.
        - `provider_description` string, nullable, required — The provider's own description for this ledger, returned unmodified. `null` when the provider gives none.
        - `pay_date` string, required — The payroll check date for this ledger, in `YYYY-MM-DD`.
        - `totals` LedgerTotals, required
          - `debit` LedgerMoney, required
            - `amount` integer, required — The amount in cents.
            - `currency` string, nullable, required — The ISO 4217 currency code.
          - `credit` LedgerMoney, required
            - `amount` integer, required — The amount in cents.
            - `currency` string, nullable, required — The ISO 4217 currency code.
          - `balanced` boolean, required — `true` when total debit equals total credit.
        - `paging` object, required
          - `count` integer — The total number of elements for the entire query (not just the given page)
          - `offset` integer, required — The current start index of the returned list of elements
        - `ledger_items` LedgerEntry[], required
          - `type` 'regular_wages' | 'overtime_wages' | 'bonus_wages' | 'paid_leave_wages' | 'severance_wages' | 'equity_compensation' | 'other_earnings' | 'expense_reimbursement' | 'contractor_payment' | 'employer_donation' | 'employer_tax_fica' | 'employer_tax_unemployment' | 'employer_tax_other' | 'employee_tax_income' | 'employee_tax_fica' | 'employee_tax_other' | 'employer_contribution_retirement' | 'employer_contribution_health' | 'employer_contribution_other' | 'pretax_deduction' | 'posttax_deduction' | 'garnishment' | 'benefit_liability' | 'tax_liability_accrual' | 'tax_receivable' | 'tax_credit_accrual' | 'cash_debit_net_pay' | 'cash_debit_tax_remittance' | 'cash_debit_other' | 'adjustment' | 'other', required — The normalized Finch classification for this entry, consistent across providers. See `account_type` for the provider's own label.
          - `account_type` string, nullable, required — The provider's own account-type label, returned unmodified.
          - `account_description` string, nullable, required — The provider's own account description, returned unmodified.
          - `debit` LedgerMoney, required
            - `amount` integer, required — The amount in cents.
            - `currency` string, nullable, required — The ISO 4217 currency code.
          - `credit` LedgerMoney, required
            - `amount` integer, required — The amount in cents.
            - `currency` string, nullable, required — The ISO 4217 currency code.
      - BatchError
        - `code` number, required
        - `finch_code` string
        - `message` string, required
        - `name` string, required

## Other responses

- `202` — The request has been accepted for processing, but data is not yet available

---

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