Sisoco Oneby Sisoco Partners

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_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.

SourceStatusLatency
Companies House streaming: filing historyLiveContinuous stream: stored as the source publishes
The Gazette — corporate insolvency notices (UK)LiveOn a schedule: cron 7 * * * * (UTC)
BODACC — procédures collectives (France)LiveOn a schedule: cron 17 */2 * * * (UTC)

Payload (data)

FieldTypeDescription
categorystringSource category, e.g. liquidation, insolvency, Procédures collectives, a Gazette notice type
descriptionstring | null
notice_codestring | nullSource code for the notice or filing (e.g. a CH form type, a Gazette notice code)
courtstring | null
published_onstring | nullYYYY-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.

SourceStatusLatency
Companies House overdue accounts and confirmation statements (derived)LiveOn a schedule: cron 41 5 * * * (UTC)

Payload (data)

FieldTypeDescription
next_duestring
days_overdueinteger

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.

SourceStatusLatency
Companies House overdue accounts and confirmation statements (derived)LiveOn a schedule: cron 41 5 * * * (UTC)

Payload (data)

FieldTypeDescription
next_duestring
days_overdueinteger

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.

SourceStatusLatency
Companies House streaming: company informationLiveContinuous stream: stored as the source publishes

Payload (data)

FieldTypeDescription
previous_statusstring | null
statusstring
status_detailstring | 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.

SourceStatusLatency
Companies House streaming: officersLiveContinuous stream: stored as the source publishes

Payload (data)

FieldTypeDescription
officer_idstring
namestring
rolestring | null
appointed_onstring | nullYYYY-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.

SourceStatusLatency
Companies House streaming: officersLiveContinuous stream: stored as the source publishes

Payload (data)

FieldTypeDescription
officer_idstring
namestring
rolestring | null
appointed_onstring | nullYYYY-MM-DD as published, or null
resigned_onstring | nullYYYY-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.

SourceStatusLatency
Companies House streaming: persons with significant controlLiveContinuous stream: stored as the source publishes

Payload (data)

FieldTypeDescription
change"notified" | "ceased" | "updated"
psc_idstring
namestring | null
kindstring | null
natures_of_controlarray of string
notified_onstring | nullYYYY-MM-DD as published, or null
ceased_onstring | nullYYYY-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.

SourceStatusLatency
Companies House streaming: chargesLiveContinuous stream: stored as the source publishes

Payload (data)

FieldTypeDescription
charge_idstring
charge_codestring | null
created_onstring | nullYYYY-MM-DD as published, or null
delivered_onstring | nullYYYY-MM-DD as published, or null
persons_entitledarray of string
classificationstring | 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.

SourceStatusLatency
Companies House streaming: chargesLiveContinuous stream: stored as the source publishes

Payload (data)

FieldTypeDescription
charge_idstring
charge_codestring | null
statusstring
satisfied_onstring | nullYYYY-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.

SourceStatusLatency
Companies House streaming: company informationLiveContinuous stream: stored as the source publishes

Payload (data)

FieldTypeDescription
previous_addressobject | null
addressobject | 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.

SourceStatusLatency
OFAC SDN and Consolidated Sanctions Lists (US Treasury)LiveOn a schedule: cron 25 */6 * * * (UTC)
UK Sanctions List (FCDO)LiveOn a schedule: cron 35 */6 * * * (UTC)
EU Consolidated Financial Sanctions ListLiveOn a schedule: cron 45 */6 * * * (UTC)

Payload (data)

FieldTypeDescription
scorenumber
matched_partyobject
matched_party.role"company" | "officer" | "psc"
matched_party.namestring
matched_party.entity_idstring
listobject
list.idstring
list.namestring
entryobject
entry.list_entry_idstring
entry.namestring
entry.matched_namestring
entry.aliasesarray of string
entry.typestring
entry.programsarray of string
entry.listed_onstring | nullYYYY-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.

SourceStatusLatency
GLEIF registration status changes (Golden Copy delta files)LiveOn a schedule: cron 20 1,9,17 * * * (UTC)

Payload (data)

FieldTypeDescription
leistring
registration_statusstring
next_renewal_datestring | nullYYYY-MM-DD as published, or null
last_updatestring | 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.

SourceStatusLatency
Companies House streaming: filing historyLiveContinuous stream: stored as the source publishes

Payload (data)

FieldTypeDescription
filing_typestring
descriptionstring
made_up_tostring | nullYYYY-MM-DD as published, or null
filed_onstring | nullYYYY-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"
}