---
title: "List held inbound emails for the firm"
method: GET
path: "/firm/client-requests/inbound-holds"
tags: ["Client Requests (Firm)"]
---

# List held inbound emails for the firm

`GET /firm/client-requests/inbound-holds`

## Request

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

Inbound emails that could not be safely routed into a request thread and await an explicit firm decision (attach, convert, or dismiss).

## Query parameters

- `state` 'held' | 'attached' | 'converted' | 'dismissed' | 'all'
- `limit` integer

## Response `200`

Held inbound emails

- object
  - `holds` object[]
    - `id` string, uuid
    - `firmOrganizationId` string, uuid
    - `organizationId` string, uuid, nullable
    - `requestId` string, uuid, nullable
    - `state` 'held' | 'attached' | 'converted' | 'dismissed'
    - `holdReason` string
    - `senderEmail` string
    - `subject` string, nullable
    - `bodyText` string, nullable
    - `decisionReason` string, nullable
    - `decidedAt` string, date-time, nullable
    - `emailReceivedAt` string, date-time, nullable
    - `createdAt` string, date-time

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