---
title: "Every deadline a UK company has, sorted, with days left"
method: GET
path: "/api/v1/deadlines"
---

# Every deadline a UK company has, sorted, with days left

`GET /api/v1/deadlines`

## Request

- Base URL: `https://meetkatalis.com`
- URL: `https://meetkatalis.com/api/v1/deadlines`
- Auth: API key in header `x-api-key`

Accounts and confirmation statement (Companies House), each director's and PSC's identity-verification date as counts (the earliest among those not yet showing as verified), the ICO data protection fee renewal (the fee register entry matching the company's name), and the next payment practices and gender pay gap reports where the company reports them. Overdue first. The reply carries the address of a free calendar feed for the company. 1 credit.

## Query parameters

- `company` string, required

## Response `200`

company, deadlines[] {kind, title, due, daysLeft, status (overdue|due_soon|upcoming|ok|check), detail, source, official}, next, couldntRead[], calendar {url}

## Other responses

- `400`: Missing company
- `401`: Missing or wrong x-api-key
- `404`: No registered company found
- `503`: Companies House couldn't be read; nothing charged

---

[API](https://skmtc.dev/meetkatalis/apis/katalis-uk-business-intelligence-apis.md) · [All operations](https://skmtc.dev/meetkatalis/apis/katalis-uk-business-intelligence-apis/llms.txt) · [OpenAPI document](https://skmtc.dev/meetkatalis/apis/katalis-uk-business-intelligence-apis/revisions/214b13088f95?raw)