---
title: "Company statutory filing health"
method: POST
path: "/kyc/verify/filing-health"
tags: ["verification"]
---

# Company statutory filing health

`POST /kyc/verify/filing-health`

## Request

- Base URL: `https://api.qorpiq.com`
- URL: `https://api.qorpiq.com/kyc/verify/filing-health`
- Auth: API key in header `x-api-key`

Annual return / financials / auditor filing history reduced to arrears signals.

## Request body

- FilingHealthRequest
  - `cin` string, required

## Response `200`

Success.

- FilingHealthResponse
  - `transaction_id` string, uuid: Unique id for this request, echoed in the X-Transaction-Id header.
  - `check` string
  - `cin` string
  - `has_filings` boolean
  - `filings_found` integer
  - `latest_financials` object, nullable
    - `form` string
    - `srn` string
    - `event_date` string
  - `latest_annual_return` object, nullable
    - `form` string
    - `srn` string
    - `event_date` string
  - `auditor_appointment_on_record` boolean: At least one ADT-1 (auditor appointment) is on MCA's record. See /kyc/verify/auditor for dates and count.
  - `latest_auditor_appointment` object, nullable
    - `form` string
    - `srn` string
    - `event_date` string
  - `financials_current` boolean: Latest AOC-4 within 18 months.
  - `annual_return_current` boolean: Latest MGT-7 within 18 months.
  - `recent_filings` object[]
    - `form` string
    - `srn` string
    - `event_date` string
  - `timestamp` integer: Response time (epoch ms).

## Other responses

- `400`: Invalid request body or parameters.
- `401`: Missing or invalid x-api-key.
- `402`: Balance too low for this call. Add money to your QorpIQ balance to continue (reason credit_balance_exhausted is kept for compatibility).
- `503`: MCA data source temporarily unavailable.

---

[API](https://skmtc.dev/qorpiq/apis/qorpiq-kyc-kyb-api.md) · [All operations](https://skmtc.dev/qorpiq/apis/qorpiq-kyc-kyb-api/llms.txt) · [OpenAPI document](https://skmtc.dev/qorpiq/apis/qorpiq-kyc-kyb-api/revisions/5a9c792b6c06?raw)