Register for a Companies House API key at developer.company-information.service.gov.uk — a streaming key is separate from the standard public data API key and must be requested specifically
Open a long-running HTTP GET connection to the streaming endpoint for filing history (the base URL and path are documented at developer-specs.company-information.service.gov.uk/streaming-api); pass your streaming API key via HTTP Basic Auth with the key as the username and an empty password
Record the timepoint value from each received event envelope; on reconnect, pass the last seen timepoint as a query parameter so the stream resumes without gaps rather than replaying from the beginning
Parse the server-sent event stream; each JSON event envelope contains resource_kind, resource_id, resource_uri, published_at, timepoint, and a data object with the filing metadata (form type, description, action date)
To fetch the full filing document list for a company triggered by a streaming event, call the Public Data API at GET https://api.company-information.service.gov.uk/company/{company_number}/filing-history using the standard REST API key
Handle disconnections gracefully — the streaming connection drops periodically; reconnect immediately with the last stored timepoint to avoid missing events
Known gotchas
The streaming API uses long-polling HTTP (not WebSocket); your HTTP client must support chunked transfer encoding and must not time out on connections that stay open for extended periods
Missing a timepoint resumption parameter on reconnect causes the stream to deliver only new events from the point of reconnection, creating gaps in your event log; always persist the last timepoint to durable storage
As of October 2025, WebFiling authentication requires GOV.UK One Login, but the Streaming API itself uses its own streaming key — do not confuse the two credential systems
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp