Events reference
Every event type: what it means, its payload, which official source emits it and how soon. Events are facts from the source, never opinions.
Each event reaches the watchlists that follow its entity, in the feed (GET /v1/events) and by webhook, as soon as it is stored. Severity is the type's default; a watchlist's profile may change it.
Event envelope
{
"api_version": "2026-11-14",
"event_id": "evt_…",
"type": "<kind>.<event>",
"severity": "info | warning | critical",
"entity": {
"id": "ent_…",
"kind": "…",
"country": "…",
"registry": "…",
"registry_id": "…",
"name": "…"
},
"related": [],
"effective_at": "…",
"observed_at": "…",
"source": {
"id": "…",
"url": "…",
"attribution": "…"
},
"data": {},
"watchlist_id": "wl_…",
"client_reference": null
}
event_id is stable: a record delivered twice by its source is stored once. Dedupe on it (delivery is at least once).
Types
company.insolvency_noticecompany.accounts_overduecompany.confirmation_statement_overduecompany.status_changedcompany.officer_appointedcompany.officer_resignedcompany.psc_changedcompany.charge_registeredcompany.charge_satisfiedcompany.address_changedcompany.sanctions_possible_matchcompany.lei_lapsedcompany.accounts_filed
company.insolvency_notice
An official insolvency notice or filing: Companies House insolvency/liquidation filings, BODACC collective procedures (FR), Gazette corporate insolvency notices.
Default severity: critical. Raises a current signal on the entity (shown by check) until it is cleared.
| Source | Status | Latency |
|---|---|---|
| Companies House streaming: filing history | Live | Continuous stream: stored as the source publishes |
| The Gazette — corporate insolvency notices (UK) | Live | On a schedule: cron 7 * * * * (UTC) |
| BODACC — procédures collectives (France) | Live | On a schedule: cron 17 */2 * * * (UTC) |
Payload (data)
| Field | Type | Description |
|---|---|---|
category | string | Source category, e.g. liquidation, insolvency, Procédures collectives, a Gazette notice type |
description | string | null | |
notice_code | string | null | Source code for the notice or filing (e.g. a CH form type, a Gazette notice code) |
court | string | null | |
published_on | string | null | YYYY-MM-DD as published, or null |
Example data (illustrative, not a real record)
{
"category": "liquidation",
"description": "Notice of statement of affairs",
"notice_code": "LIQ02",
"court": null,
"published_on": "2026-11-14"
}
company.accounts_overdue
Annual accounts not filed by their due date (derived daily from Companies House due dates).
Default severity: warning. Raises a current signal on the entity (shown by check) until it is cleared.
| Source | Status | Latency |
|---|---|---|
| Companies House overdue accounts and confirmation statements (derived) | Live | On a schedule: cron 41 5 * * * (UTC) |
Payload (data)
| Field | Type | Description |
|---|---|---|
next_due | string | |
days_overdue | integer |
Example data (illustrative, not a real record)
{
"next_due": "2026-10-01",
"days_overdue": 45
}
company.confirmation_statement_overdue
Confirmation statement not filed by its due date (derived daily from Companies House due dates).
Default severity: warning. Raises a current signal on the entity (shown by check) until it is cleared.
| Source | Status | Latency |
|---|---|---|
| Companies House overdue accounts and confirmation statements (derived) | Live | On a schedule: cron 41 5 * * * (UTC) |
Payload (data)
| Field | Type | Description |
|---|---|---|
next_due | string | |
days_overdue | integer |
Example data (illustrative, not a real record)
{
"next_due": "2026-10-15",
"days_overdue": 31
}
company.status_changed
The register status changed (e.g. active → liquidation, dissolved).
Default severity: warning.
| Source | Status | Latency |
|---|---|---|
| Companies House streaming: company information | Live | Continuous stream: stored as the source publishes |
Payload (data)
| Field | Type | Description |
|---|---|---|
previous_status | string | null | |
status | string | |
status_detail | string | null |
Example data (illustrative, not a real record)
{
"previous_status": "active",
"status": "liquidation",
"status_detail": null
}
company.officer_appointed
A director, secretary or member was appointed.
Default severity: info.
| Source | Status | Latency |
|---|---|---|
| Companies House streaming: officers | Live | Continuous stream: stored as the source publishes |
Payload (data)
| Field | Type | Description |
|---|---|---|
officer_id | string | |
name | string | |
role | string | null | |
appointed_on | string | null | YYYY-MM-DD as published, or null |
Example data (illustrative, not a real record)
{
"officer_id": "example-officer-id",
"name": "EXAMPLE, Jane",
"role": "director",
"appointed_on": "2026-11-03"
}
company.officer_resigned
An officer resigned or was removed.
Default severity: info.
| Source | Status | Latency |
|---|---|---|
| Companies House streaming: officers | Live | Continuous stream: stored as the source publishes |
Payload (data)
| Field | Type | Description |
|---|---|---|
officer_id | string | |
name | string | |
role | string | null | |
appointed_on | string | null | YYYY-MM-DD as published, or null |
resigned_on | string | null | YYYY-MM-DD as published, or null |
Example data (illustrative, not a real record)
{
"officer_id": "example-officer-id",
"name": "EXAMPLE, John",
"role": "secretary",
"appointed_on": "2019-04-01",
"resigned_on": "2026-11-10"
}
company.psc_changed
A person with significant control was notified, ceased, or their nature of control changed.
Default severity: info.
| Source | Status | Latency |
|---|---|---|
| Companies House streaming: persons with significant control | Live | Continuous stream: stored as the source publishes |
Payload (data)
| Field | Type | Description |
|---|---|---|
change | "notified" | "ceased" | "updated" | |
psc_id | string | |
name | string | null | |
kind | string | null | |
natures_of_control | array of string | |
notified_on | string | null | YYYY-MM-DD as published, or null |
ceased_on | string | null | YYYY-MM-DD as published, or null |
Example data (illustrative, not a real record)
{
"change": "notified",
"psc_id": "example-psc-id",
"name": "Example Holdings Limited",
"kind": "corporate-entity-person-with-significant-control",
"natures_of_control": [
"ownership-of-shares-75-to-100-percent"
],
"notified_on": "2026-11-05",
"ceased_on": null
}
company.charge_registered
A charge (security) was registered against the company.
Default severity: info.
| Source | Status | Latency |
|---|---|---|
| Companies House streaming: charges | Live | Continuous stream: stored as the source publishes |
Payload (data)
| Field | Type | Description |
|---|---|---|
charge_id | string | |
charge_code | string | null | |
created_on | string | null | YYYY-MM-DD as published, or null |
delivered_on | string | null | YYYY-MM-DD as published, or null |
persons_entitled | array of string | |
classification | string | null |
Example data (illustrative, not a real record)
{
"charge_id": "example-charge-id",
"charge_code": "000000000001",
"created_on": "2026-11-01",
"delivered_on": "2026-11-08",
"persons_entitled": [
"Example Bank PLC"
],
"classification": "A registered charge"
}
company.charge_satisfied
A charge was satisfied in full or in part.
Default severity: info.
| Source | Status | Latency |
|---|---|---|
| Companies House streaming: charges | Live | Continuous stream: stored as the source publishes |
Payload (data)
| Field | Type | Description |
|---|---|---|
charge_id | string | |
charge_code | string | null | |
status | string | |
satisfied_on | string | null | YYYY-MM-DD as published, or null |
Example data (illustrative, not a real record)
{
"charge_id": "example-charge-id",
"charge_code": "000000000001",
"status": "fully-satisfied",
"satisfied_on": "2026-11-12"
}
company.address_changed
The registered office address changed.
Default severity: info.
| Source | Status | Latency |
|---|---|---|
| Companies House streaming: company information | Live | Continuous stream: stored as the source publishes |
Payload (data)
| Field | Type | Description |
|---|---|---|
previous_address | object | null | |
address | object | null |
Example data (illustrative, not a real record)
{
"previous_address": {
"address_line_1": "1 Example Street",
"locality": "London",
"postal_code": "EC1A 1AA"
},
"address": {
"address_line_1": "2 Sample Road",
"locality": "Manchester",
"postal_code": "M1 1AA"
}
}
company.sanctions_possible_match
The company, or one of its officers or PSCs, possibly matches an entry on an official sanctions list. A possible match with a score, never a determination: review the listed record.
Default severity: critical. Raises a current signal on the entity (shown by check) until it is cleared.
| Source | Status | Latency |
|---|---|---|
| OFAC SDN and Consolidated Sanctions Lists (US Treasury) | Live | On a schedule: cron 25 */6 * * * (UTC) |
| UK Sanctions List (FCDO) | Live | On a schedule: cron 35 */6 * * * (UTC) |
| EU Consolidated Financial Sanctions List | Live | On a schedule: cron 45 */6 * * * (UTC) |
Payload (data)
| Field | Type | Description |
|---|---|---|
score | number | |
matched_party | object | |
matched_party.role | "company" | "officer" | "psc" | |
matched_party.name | string | |
matched_party.entity_id | string | |
list | object | |
list.id | string | |
list.name | string | |
entry | object | |
entry.list_entry_id | string | |
entry.name | string | |
entry.matched_name | string | |
entry.aliases | array of string | |
entry.type | string | |
entry.programs | array of string | |
entry.listed_on | string | null | YYYY-MM-DD as published, or null |
Example data (illustrative, not a real record)
{
"score": 0.92,
"matched_party": {
"role": "officer",
"name": "EXAMPLE, John",
"entity_id": "ent_example"
},
"list": {
"id": "uk",
"name": "UK Sanctions List"
},
"entry": {
"list_entry_id": "EXAMPLE0001",
"name": "John EXAMPLE",
"matched_name": "John EXAMPLE",
"aliases": [],
"type": "individual",
"programs": [
"Example regime"
],
"listed_on": "2024-03-01"
}
}
company.lei_lapsed
The company's LEI registration lapsed (not renewed), per GLEIF.
Default severity: warning. Raises a current signal on the entity (shown by check) until it is cleared.
| Source | Status | Latency |
|---|---|---|
| GLEIF registration status changes (Golden Copy delta files) | Live | On a schedule: cron 20 1,9,17 * * * (UTC) |
Payload (data)
| Field | Type | Description |
|---|---|---|
lei | string | |
registration_status | string | |
next_renewal_date | string | null | YYYY-MM-DD as published, or null |
last_update | string | null |
Example data (illustrative, not a real record)
{
"lei": "000000EXAMPLE0000000",
"registration_status": "LAPSED",
"next_renewal_date": "2026-11-01",
"last_update": "2026-11-02T09:20:00Z"
}
company.accounts_filed
Annual accounts were filed at Companies House (clears an accounts-overdue signal).
Default severity: info. Clears: company.accounts_overdue.
| Source | Status | Latency |
|---|---|---|
| Companies House streaming: filing history | Live | Continuous stream: stored as the source publishes |
Payload (data)
| Field | Type | Description |
|---|---|---|
filing_type | string | |
description | string | |
made_up_to | string | null | YYYY-MM-DD as published, or null |
filed_on | string | null | YYYY-MM-DD as published, or null |
Example data (illustrative, not a real record)
{
"filing_type": "AA",
"description": "Accounts for a small company",
"made_up_to": "2026-03-31",
"filed_on": "2026-11-11"
}