Status API
Read-only, no key, cross-origin allowed, cached at the edge for 30 seconds. Every response carries an ETag and Last-Modified, so conditional requests are cheap. Times are ISO 8601 with the UK offset.
Endpoints
Overall state, label, headline and message, one state per component, active incident count. The endpoint to poll.
The full payload: groups, components with metrics and 90-day history, incidents with update timelines, maintenance windows.
Incidents (open and resolved in the last 30 days) and maintenance windows only.
Per-component daily history for 90 days with minutes degraded, out or in maintenance.
Atom feed of incidents and maintenance windows for readers and chat integrations.
A small SVG badge for one component, or the overall state without the parameter.
Plain text: ok or stale plus the snapshot age in seconds. For uptime monitors. Never cached.
OpenAPI 3 description of these endpoints and their schemas.
A plain-text guide for AI agents: what the states mean and how to read the numbers.
Reading the states
overall.state is #GoFile's own state: operational, degraded or outage when a #GoFile component is affected; external when an HMRC or Companies House service is impaired and #GoFile itself is fine; maintenance during a published window; unknown when monitoring is delayed. headline and message are the wording shown to customers.
Component states are operational, degraded, outage, maintenance or unknown. Counts are published as buckets (none, some, several, many); rates as percentages. For filing services, resolved_share_24h is the share of filings that reached HMRC in the last 24 hours and have any HMRC result; waiting_over_2h is the backlog; held_unresolved counts filings left without a final HMRC result (held or ambiguous) and awaiting reconciliation; the timing metrics cover only filings that got a result. A filing service shows unknown when our own result checks are running late, so a backlog is never put down to HMRC when it may be ours.
Nothing in the API identifies a customer or a filing. Fields are only ever added within version 1.