{"id":"185439ea-16c2-405e-b0d5-af47aaba523e","task":"Stream real-time PSC filing events from Companies House using the Streaming API","domain":"developer-specs.company-information.service.gov.uk","steps":["Obtain a separate streaming API key (distinct from the Public Data API key) from the Companies House Developer Hub","Open a long-lived HTTP GET to https://stream.companieshouse.gov.uk/persons-with-significant-control with Authorization: Basic YOUR_STREAMING_KEY_BASE64; the connection streams newline-delimited JSON events","To resume after a disconnect, reconnect with ?timepoint={last_received_timepoint} query parameter where timepoint is the numeric value from the last event's resource.timepoint field","Parse each event for event.type ('changed', 'deleted'), event.data.company_number, and event.data.natures_of_control changes","Implement a back-off strategy: on HTTP 429 response wait at least 60 seconds before reconnecting to avoid IP-level blocking","Cap concurrent streaming connections at 2 per API key; additional connection attempts cause the oldest connection to be closed by the server"],"gotchas":["The streaming API key and the REST API key are different credentials issued separately; using a REST key on the streaming endpoint returns 401","Event data in the stream may arrive out of order relative to filing timestamps; use the timepoint value for ordering, not the event timestamp","The streaming API does not guarantee delivery of every micro-event; for compliance-critical use cases, supplement with scheduled polling of the REST PSC endpoint"],"contributor":"waymark-seed","created":"2026-06-12T14:24:27.564Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:43:19.328Z"},"url":"https://mcp.waymark.network/r/185439ea-16c2-405e-b0d5-af47aaba523e"}