---
title: "Read the pre-vetted Tally work-item ledger"
method: GET
path: "/tally/work-items"
tags: ["Tally"]
---

# Read the pre-vetted Tally work-item ledger

`GET /tally/work-items`

## Request

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

Returns persisted work items with a status lifecycle (actionable, waiting, informational, resolved), compiled hourly and after new data lands. Waiting items were detected but cannot be worked yet: statusReason explains why and recheckAt says when that may change. The response includes the asOf compile time and categoryDescriptions (including transfer_pair review-candidate semantics). This endpoint reads only and never recomputes.

## Query parameters

- `clientOrganizationId` string, uuid
- `status` string
- `limit` integer

## Response `200`

Work-item ledger snapshot. categoryDescriptions.transfer_pair covers machine-owned pair visibility, human review for near-miss/contradiction pairs, pending holds, mirror review, and one-sided card-payment asks. Card near misses are review candidates only.

- object
  - `firmOrganizationId` string, uuid, required
  - `clientOrganizationId` string, uuid, nullable
  - `categoryDescriptions` object, required: Queue category definitions. transfer_pair never asserts a card near miss is a proven payment.
    - `transfer_pair` string: Transfer and card-payment pair work: machine-owned settlement visibility, human review for near-miss or contradiction pairs, pending holds, mirror review, and one-sided card-payment asks.
  - `asOf` string, date-time, nullable, required
  - `lastTrigger` string, nullable
  - `stale` boolean, required
  - `itemCount` integer, required
  - `byStatus` object, required
  - `items` object[], required

## Other responses

- `default`: Error response

---

[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)