---
title: "List processed payrolls from the cached Gusto history"
method: GET
path: "/payroll/history"
tags: ["Payroll"]
---

# List processed payrolls from the cached Gusto history

`GET /payroll/history`

## Request

- Base URL: `https://ledgerhq.pro/api/v1`
- URL: `https://ledgerhq.pro/api/v1/payroll/history`
- Auth: one of:
  - HTTP bearer and API key in header `x-organization-id`
  - HTTP bearer and API key in header `x-organization-id`

Processed payrolls with aggregate totals, newest check date first. Read-only; synthetic demo/training companies can include explicitly labeled sample payroll without a provider connection. Served from the org's payroll snapshot cache (synced via POST /payroll/sync) — no per-request Gusto call. Scoped to the authorized organization; on the firm's own books, payroll data is restricted to the firm owner.

## Query parameters

- `startDate` string, date
- `endDate` string, date

## Response `200`

{payrolls:[...]}

- object
  - `payrolls` object[]
    - `uuid` string, uuid
    - `checkDate` string, date, nullable
    - `periodStart` string, date, nullable
    - `periodEnd` string, date, nullable
    - `processed` boolean
    - `offCycle` boolean
    - `employeeCount` integer
    - `totals` object
      - `grossPay` integer
      - `netPay` integer
      - `employeeTaxes` integer
      - `employerTaxes` integer
      - `deductions` integer
      - `companyDebit` integer

---

[API](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api.md) · [All operations](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api/revisions/9a8269f0a586?raw)