---
title: "Corporate event timeline"
method: GET
path: "/company-events/timeline"
tags: ["Events"]
---

# Corporate event timeline

`GET /company-events/timeline`

## Request

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

Returns the event history for a single company, newest first (ordered by event date, most recent first). One of `company_number` or `company_name` is required. For `country=FI|SE|BE|HR|DK|EE|SK|CH|LV|CY|RO|US|LT|CA|AU|JP|IL|SG|CO|TW|BR|CZ|DE` the timeline holds register-change events, dated when first seen in the register data (for the United States, the weekly read of the registers that first sees it).

## 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_number` string
- `company_name` string
- `limit` integer
- `include` 'notice'

## Response `200`

Event timeline

- 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
  - `meta` Meta
    - `query_ms` integer
    - `search_mode` string
    - `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'
    - `rate_limit` RateLimitMeta
      - `rpm_remaining` integer
      - `daily_remaining` integer

## 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)