---
title: "Get corporate event by ID"
method: GET
path: "/company-events/records/{id}"
tags: ["Events"]
---

# Get corporate event by ID

`GET /company-events/records/{id}`

## Request

- Base URL: `https://api.prometiam.com/functions/v1/risk-api`
- URL: `https://api.prometiam.com/functions/v1/risk-api/company-events/records/{id}`
- Auth: HTTP bearer

Fetch a single corporate event by numeric ID. Returns full event detail including `raw_data` (omitted from search results). Ids emitted 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 resolve here like any other.

## Path parameters

- `id` integer, required

## Query parameters

- `include` 'notice'

## Response `200`

Event detail

- object
  - `data` EventDetail
    - `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
    - `raw_data` object, nullable

## Other responses

- `401`: Missing, invalid, or expired API key
- `404`: Record or endpoint not found
- `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)