---
title: "Search corporate events, or a country's event feed"
method: GET
path: "/company-events/search"
tags: ["Events"]
---

# Search corporate events, or a country's event feed

`GET /company-events/search`

## Request

- Base URL: `https://api.prometiam.com/functions/v1/risk-api`
- URL: `https://api.prometiam.com/functions/v1/risk-api/company-events/search`
- Auth: HTTP bearer

Search normalized company lifecycle events by company name or registration number. Without either, the call is the country's event feed (since 17 Oct 2026): every event of `country` (then required), newest first, from `date_from` (default 7 days ago, at most 31 days back) to `date_to`, filterable by `event_type`, paged with the same `cursor`, 2 credits a call; `meta.search_mode` is `country_feed` and `meta.feed_window` states the window. A `date_from` older than 31 days is refused with 400. Event types: `new_incorporation`, `director_change`, `capital_change`, `address_change`, `name_change`, `merger`, `demerger`, `dissolution`, `liquidation`, `insolvency`, `status_change`, `filing`, `correction`, `object_change`, `bylaws_change`, `legal_form_change`, `ownership_change`, `power_of_attorney`, `sale_of_business`, `debt_default`, `registry_closure`, `registry_reopening`, `reactivation`, `litigation`, `securities_issue`, `branch`, `charge`, `resolution`, `website`, `other`. 9 Oct 2026: 19 finer types are served; `event_type=status_change` now matches only status changes no finer type describes (for ES it matches no BORME act any more); `power_of_attorney` (BORME Apoderamiento) used to be `director_change`, `securities_issue` used to be `capital_change`, `sale_of_business` (FR vente/cession) used to be `merger`. FI/SE/BE/HR/DK/EE/SK/US register-change events now carry `legal_form_change`, `reactivation` and `other` (removed from register) instead of `status_change`. Signals: `registry_closure`, `debt_default` and `litigation` are `distress`; `reactivation` and `registry_reopening` are `growth`; the rest of the new types are `neutral`. Matches for ES, FR and GB alike, derived from each register's own act/filing code (see `Event.act_type`); a raw GB Companies House code (e.g. `OFFICER_CHANGE`) still works as an alias. Norway, Ireland and Poland publish no corporate-event gazette: `country=NO|IE|PL` returns register-change events (name, status, legal form, registered address), dated when the change first appears in the register data, none before 14 Oct 2026 (the same act types as below). Finland, Sweden, Belgium, Croatia, Denmark, Estonia, Slovakia, Switzerland, Latvia, Cyprus, Romania, Lithuania, Canada, Australia, Japan, Israel, Singapore, Colombia, Taiwan, Brazil, the Czech Republic, Germany and the United States publish no gazette either: `country=FI|SE|BE|HR|DK|EE|SK|CH|LV|CY|RO|US|LT|CA|AU|JP|IL|SG|CO|TW|BR|CZ|DE` returns register-change events (`act_type` `registered`, `name_change`, `legal_form_change`, `address_change`, `capital_change` for HR, EE, SK, CH, LV, LT, TW, BR and CZ, `status:<token>`, `removed_from_register`, `returned_to_register`), dated by the load that first saw the change (`raw_data.date_basis` is `first_seen_in_register`), never by the date the register published it. An empty list means no change has been seen yet.

## Query parameters

- `country` 'ES' | 'FR' | 'GB' | 'IE' | 'PL' | 'NO' | 'FI' | 'SE' | 'HR' | 'BE' | 'DK' | 'EE' | 'SK' | 'CH' | 'LV' | 'CY' | 'RO' | 'LT' | 'CA' | 'AU' | 'JP' | 'IL' | 'BR' | 'CO' | 'SG' | 'TW' | 'CZ' | 'DE' | 'US'
- `company_name` string
- `company_number` string
- `event_type` 'new_incorporation' | 'director_change' | 'capital_change' | 'address_change' | 'name_change' | 'merger' | 'demerger' | 'dissolution' | 'liquidation' | 'insolvency' | 'status_change' | 'filing' | 'correction' | 'object_change' | 'bylaws_change' | 'legal_form_change' | 'ownership_change' | 'power_of_attorney' | 'sale_of_business' | 'debt_default' | 'registry_closure' | 'registry_reopening' | 'reactivation' | 'litigation' | 'securities_issue' | 'branch' | 'charge' | 'resolution' | 'website' | 'other'
- `date_from` string, date
- `date_to` string, date
- `limit` integer
- `cursor` string
- `include` 'notice'

## Response `200`

Event search results

- object
  - `data` Event[]
    - `id` integer
    - `company_name` string
    - `company_number` string, nullable
    - `vat_number` string, nullable
    - `country` 'ES' | 'FR' | 'GB' | 'IE' | 'PL' | 'NO' | 'FI' | 'SE' | 'BE' | 'HR' | 'DK' | 'EE' | 'SK' | 'CH' | 'LV' | 'CY' | 'RO' | 'LT' | 'CA' | 'AU' | 'JP' | 'IL' | 'SG' | 'CO' | 'TW' | 'BR' | 'CZ' | 'DE' | 'US'
    - `source` string
    - `event_type` 'new_incorporation' | 'director_change' | 'capital_change' | 'address_change' | 'name_change' | 'merger' | 'demerger' | 'dissolution' | 'liquidation' | 'insolvency' | 'status_change' | 'filing' | 'correction' | 'object_change' | 'bylaws_change' | 'legal_form_change' | 'ownership_change' | 'power_of_attorney' | 'sale_of_business' | 'debt_default' | 'registry_closure' | 'registry_reopening' | 'reactivation' | 'litigation' | 'securities_issue' | 'branch' | 'charge' | 'resolution' | 'website' | 'other': Derived from `act_type` through the multilingual mapping dictionary (scripts/shared/vocabulary/corporate_events.json). Falls back to the raw stored value (a literal `status_change` default for ES/FR, or the raw GB code) when the dictionary does not cover this act_type yet.
    - `act_type` string, nullable: Raw register code `event_type` was derived from: a BORME act code (ES), a BODACC famille/jugement code (FR), or a Companies House filing category / Gazette notice type (GB). For FI, SE, BE, HR, DK, EE, SK, CH, LV, CY, RO, LT, CA, AU, JP, IL, SG, CO, TW, BR, CZ, DE and US: `registered`, `name_change`, `legal_form_change`, `address_change`, `capital_change` (HR, EE, SK, CH, LV, LT, TW, BR, CZ), `status:<register status>`, `removed_from_register` or `returned_to_register`, derived from a change between two loads of the register data. Null for GB/IE/PL/NO rows this dictionary does not cover (Norway publishes no event gazette; Ireland and Poland are company-level).
    - `event_date` string, date
    - `previous_value` string, nullable
    - `new_value` string, nullable
    - `event_detail` string, nullable
    - `notice_url` string, uri, nullable
    - `notice` EventNotice, nullable: Only with `include=notice`: the publication behind the event. ES: the BORME page; FR: the BODACC announcement; GB: the Companies House filing. Null for events of other countries, which have no notice.
      - `id` integer
      - `source` 'BORME' | 'BODACC' | 'Companies House'
      - `published_date` string, date, nullable
      - `reference` string, nullable
      - `type` string, nullable
      - `court` string, nullable
      - `region` string, nullable
      - `url` string, uri, nullable
  - `pagination` Pagination
    - `count` integer: Number of items in this response
    - `has_more` boolean
    - `next_cursor` string, nullable: Pass as `cursor` to fetch the next page

## Other responses

- `400`: Missing or invalid parameters
- `401`: Missing, invalid, or expired API key
- `429`: Rate limit exceeded — see `Retry-After` header for seconds until reset

---

[API](https://skmtc.dev/prometiam/apis/prometiam-risk-intelligence-api.md) · [All operations](https://skmtc.dev/prometiam/apis/prometiam-risk-intelligence-api/llms.txt) · [OpenAPI document](https://skmtc.dev/prometiam/apis/prometiam-risk-intelligence-api/revisions/3ee0626d5a45?raw)