---
title: "Read firm work that is blocked on human input"
method: GET
path: "/tally/human-input"
tags: ["Tally"]
---

# Read firm work that is blocked on human input

`GET /tally/human-input`

## Request

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

Returns only work Tally cannot continue without a firm member's answer, decision, approval, consent, credential entry, or external action. This is narrower than the general work-item ledger and excludes ordinary bookkeeping volume, informational rows, and work waiting on clients, providers, or time.

## Query parameters

- `limit` integer

## Response `200`

Canonical firm human-input summary

- object
  - `humanInput` object, required
    - `enabled` boolean, required
    - `generatedAt` string, date-time, required
    - `asOf` string, date-time, nullable
    - `partial` boolean, required
    - `sourceErrors` object[], required
    - `requestCount` object, required
      - `needsFirm` integer, required
      - `heldInbound` integer, required
      - `badge` integer, required
    - `eligibleCount` integer, required
    - `remainingCount` integer, required
    - `items` object[], required
      - `id` string, required
      - `version` string, required
      - `sourceKind` 'request_messages' | 'approval' | 'presented_question' | 'work_item', required
      - `reasonCode` string, required
      - `interactionMode` 'start_discussion' | 'open_existing', required
      - `urgencyTier` integer, required
      - `title` string, required
      - `detail` string, required
      - `company` object, nullable
      - `count` integer, nullable
      - `affectedAmountCents` integer, nullable: Affected amount in integer cents when known.
      - `waitingSince` string, date-time, nullable
      - `dueAt` string, date-time, nullable
      - `assignedUser` object, nullable
      - `requiredPermission` string, nullable
      - `canAct` boolean, required
      - `focus` object, nullable

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