Company status and filing deadlines

For accountants, bookkeepers and anyone who runs a few companies: is the company active, and when are the accounts and the confirmation statement due?

Two routes, both read the public Companies House register:

GET /v1/company?number= returns status, incorporation date, SIC codes and both deadlines.
GET /v1/company/due?number= returns the next deadline, days left, and attention: true when anything is overdue or due within 30 days.

Company profile data only. fetch.li never returns directors, persons with significant control, addresses of people, or filing documents.

Try it

https://fetch.li/v1/company/due?number=17019367

Parameters

Parameter	Required	Description
`number`	Yes	UK company number. Eight digits, or two letters and six digits (`SC123456`, `OC301234`, `NI012345`). Short numbers are padded, so `1234` becomes `00001234`.

Answer

{
  "ok": true,
  "answer": "135",
  "say": "TIDALUX LTD: Confirmation statement is due on 2027-02-23, in 135 days.",
  "yes": false,
  "number": "17019367",
  "name": "TIDALUX LTD",
  "status": "active",
  "active": true,
  "next": { "what": "confirmation_statement", "due": "2027-02-23", "days_left": 135, "overdue": false },
  "accounts": { "next_due": "2027-11-10", "days_left": 395, "overdue": false, "state": "ok" },
  "confirmation_statement": { "next_due": "2027-02-23", "days_left": 135, "overdue": false, "state": "ok" },
  "attention": false,
  "checked_on": "2026-10-11",
  "source_url": "https://find-and-update.company-information.service.gov.uk/company/17019367"
}

state is overdue, due_soon (30 days or fewer), ok, or none when Companies House lists no date. yes is the same as attention, so a Zapier or Make filter can test one field. Days are counted in UK time.

Freshness

Answers are cached for up to 6 hours. Companies House updates deadlines when a filing is accepted, so a deadline can take a few hours to move after you file. Always follow the link in source_url before you rely on a date.

Errors

HTTP	`error.code`	Meaning
400	`invalid_query`	Not a UK company number.
404	`not_found`	No such company at Companies House.
502	`upstream_error`	Companies House is slow or our 5 minute budget is used. Retry shortly.
503	`unavailable`	Company lookups are not switched on for this host yet.

Watching lots of companies?

If you would rather not build the loop yourself, LoopOnyx Filing Watch is our own small service on top of this endpoint: add your client companies once and get one calm email when something is coming due. It is on a waitlist for now. Company data only, never people.

Need a website or hosting for a new company? Tidalux, the studio behind fetch.li, builds and looks after small UK sites.

Plans

The demo tier works without a key at a low hourly limit. Starter and up use your API key and plan limits. See Pricing.

Data: Companies House public data, Crown copyright, Open Government Licence v3.0.

Try it

GET https://fetch.li/v1/company/due

Answer

Response

response