---
title: "List Intake Requests"
method: GET
path: "/internal/api/clients/{client_id}/intake-requests"
tags: ["CLIENT", "Intake Requests"]
---

# List Intake Requests

`GET /internal/api/clients/{client_id}/intake-requests`

## Request

- Base URL: `https://api.signalshq.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.signalshq.io/internal/api/clients/{client_id}/intake-requests`
- Auth: OAuth 2
  - Password
  - Token URL: `/auth/login`

List all intake requests for a client with optional status filtering.

## Path parameters

- `client_id` string, uuid, required: Client ID

## Query parameters

- `status_filter` string, nullable
- `limit` integer
- `offset` integer

## Response `200`

Successful Response

- DocumentUploadRequestSummaryResponse[]
  - `id` string, uuid, required: Unique identifier for the upload request
  - `request_title` string, required: Title of the upload request
  - `status` 'DRAFT' | 'EMAIL_SENT' | 'ACTIVE' | 'COMPLETED' | 'EXPIRED' | 'REVOKED', required: Enum for intake request status
  - `total_items` integer, required: Total number of items requested
  - `completed_items` integer, required: Number of items completed
  - `expires_at` string, date-time, required: When the upload link expires
  - `created_at` string, date-time, required: When the request was created
  - `created_by` string, required: User who created the request
  - `questionnaire_from_pyr` string, nullable: Questionnaire processing status for previous year return (if applicable for this intake request)
  - `document_checklist_suggestion` string, nullable: Document checklist processing status for previous year return (if applicable for this intake request)

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/signalshq/apis/signals-api.md) - [All operations](https://skmtc.dev/signalshq/apis/signals-api/llms.txt) - [OpenAPI document](https://skmtc.dev/signalshq/apis/signals-api/revisions/2c22af3b5576?raw)
