---
title: "\"Ready to Prepare?\" gate — role-stateful readiness for a client/tax-year."
method: GET
path: "/internal/api/clients/{client_id}/dms/document-flags/readiness"
tags: ["CLIENT", "Client Document Management", "DMS Document Flags"]
---

# "Ready to Prepare?" gate — role-stateful readiness for a client/tax-year.

`GET /internal/api/clients/{client_id}/dms/document-flags/readiness`

## 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}/dms/document-flags/readiness`
- Auth: OAuth 2
  - Password
  - Token URL: `/auth/login`

## Path parameters

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

## Query parameters

- `tax_year` string, required

## Response `200`

Successful Response

- ReadinessResponse: The "Ready to Prepare?" gate for a client/tax-year (spec: panel v4).
  - `tax_year` string, required
  - `overall_state` string, required
  - `must_resolve_total` integer, required
  - `review_items_total` integer, required
  - `info_total` integer, required
  - `phases` object, required
  - `intake_completeness` unknown

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