---
title: "List the firm-wide client-request queue"
method: GET
path: "/firm/client-requests"
tags: ["Client Requests (Firm)"]
---

# List the firm-wide client-request queue

`GET /firm/client-requests`

## Request

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

Aggregate Client Requests queue across every firm-managed company. Authenticate against the firm workspace (x-organization-id = firm id for OAuth; agent API keys are firm-anchored by default). Returns priority-ordered rows plus per-filter counts, or company-grouped statement and bank-feed obligations when view=companies.

## Query parameters

- `view` 'companies'
- `filter` 'open' | 'needs_firm' | 'waiting_on_client' | 'follow_up_due' | 'resolved' | 'dismissed' | 'history' | 'all'
- `companyOrganizationId` string, uuid
- `assignedActor` 'tally' | 'firm_user'
- `assignedUserId` string, uuid
- `requestType` 'question' | 'document_statement' | 'document_receipt' | 'document_other' | 'task' | 'message' | 'bank_reconnect' | 'bank_connection'
- `ownerEmail` string
- `search` string
- `page` integer
- `limit` integer

## Response `200`

Firm queue rows, total, and per-filter counts

- object
  - `requests` object[]
    - `id` string, uuid
    - `organizationId` string, uuid
    - `companyName` string, nullable
    - `workflowState` 'draft' | 'waiting_on_client' | 'needs_firm' | 'resolved' | 'dismissed'
    - `status` string
    - `requestType` string
    - `subject` string, nullable
    - `goal` string, nullable
    - `question` string
    - `assignedActor` 'tally' | 'firm_user'
    - `assignedUserId` string, uuid, nullable
    - `assignedUserName` string, nullable
    - `dueDate` string, date-time, nullable
    - `nextFollowUpAt` string, date-time, nullable
    - `followUpState` 'active' | 'paused'
    - `followUpCount` integer
    - `followUpDue` boolean
    - `lastInboundAt` string, date-time, nullable
    - `lastOutboundAt` string, date-time, nullable
    - `lastActivityAt` string, date-time, nullable
    - `resolutionReason` string, nullable
    - `resolvedAt` string, date-time, nullable
    - `participants` object[]
      - `name` string, nullable
      - `email` string
    - `lastMessagePreview` string, nullable
    - `lastMessageAt` string, date-time, nullable
    - `sending` boolean
    - `nextActor` 'firm' | 'tally' | 'client' | 'none'
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
  - `total` integer
  - `counts` object
    - `open` integer
    - `needsFirm` integer
    - `waitingOnClient` integer
    - `followUpDue` integer
    - `resolved` integer
    - `dismissed` integer
    - `heldInbound` integer

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