Developer preview

    Registry change webhooks

    We re-read official registers on a schedule and post you the difference. Being straight about the state of this: the change detection runs today and drives our own customer emails, but the outbound HTTP webhook is in developer preview — you can send yourself test events now, and we onboard live delivery by hand while we learn what shapes people actually need.

    Event taxonomy

    company.status_changed
    Developer preview

    The official status on the register changed — active, dissolved, in liquidation, struck off.

    company.name_changed
    Developer preview

    The registered company name changed.

    company.address_changed
    Developer preview

    The registered address changed.

    company.legal_form_changed
    Developer preview

    The legal form changed.

    company.no_change
    Developer preview

    We re-read the register on schedule and nothing moved. Sent only if you ask for it — silence is otherwise the default.

    register.unavailable
    Developer preview

    The register itself stopped answering our probe, so absence of change events means nothing until it recovers.

    company.officers_changed
    Planned — not built

    A director or officer was appointed or resigned.

    company.filing_published
    Planned — not built

    A new filing appeared on the register.

    Payload shape

    POST https://your-endpoint.example.com/lemreveal
    Content-Type: application/json
    X-LemReveal-Event: company.status_changed
    
    {
      "event": "company.status_changed",
      "source": "LemReveal",
      "api_version": "v1",
      "is_test": false,
      "timestamp": "2026-09-20T08:14:22Z",
      "data": {
        "entity_id": "lr_gb_09926980",
        "country": "GB",
        "company_name": "MONZO BANK LIMITED",
        "registration_number": "09926980",
        "register": {
          "name": "Companies House",
          "official_url": "https://find-and-update.company-information.service.gov.uk/company/09926980"
        },
        "change": {
          "field": "status",
          "previous": "active",
          "current": "liquidation",
          "observed_at": "2026-09-20T08:14:22Z"
        },
        "provenance": {
          "source_mode": "live",
          "source_url": "https://find-and-update.company-information.service.gov.uk/company/09926980",
          "retrieved_at": "2026-09-20T08:14:22Z"
        }
      }
    }

    Every event carries provenance: which register, the exact URL, and when we read it. Test events set is_test: true and an X-LemReveal-Test: true header, so you can never mistake one for the real thing.

    Where change detection runs today

    Automatic re-reads run on 6 countries' registers:

    Loading…

    Everywhere else you can still search and retrieve records on demand — we just will not pretend to watch a register we cannot reliably re-read.

    See the full coverage matrix

    Send yourself a test event

    The simulator posts a real HTTP request from our servers to your endpoint, with the exact payload shape above, so you can build your handler before we onboard you. Private and internal addresses are refused.

    Open the webhook tester

    Requires a free account.

    Need live delivery at volume?

    Tell us your countries, volumes and the events that matter. No payment, and a straight answer about what we can serve today.

    Request production access

    These events describe official company registration data only. LemReveal does not provide sanctions, adverse-media or credit screening, and holds no compliance certification.