---
title: "/companies/{cvr}/timeline"
method: GET
path: "/v1/companies/{cvr}/timeline"
tags: ["Companies"]
---

# /companies/{cvr}/timeline

`GET /v1/companies/{cvr}/timeline`

## Request

- Base URL: `https://api.companydata.dk` (the document declares no server; this is the origin it was published from)
- URL: `https://api.companydata.dk/v1/companies/{cvr}/timeline`
- Auth: HTTP bearer

Get timeline of corporate events for a company.

Returns historical events including:
- Company founding
- Director changes (joined/left)
- Board member changes (joined/left)
- Ownership changes
- Auditor changes
- Status changes (bankruptcy, liquidation, etc.)

Events are sorted by date (newest first).

## Path parameters

- `cvr` string, required

## Response `200`

Successful Response

- CompanyTimelineResponse: Response for company timeline endpoint.
  - `cvr` string, required: CVR number of the company
  - `company_name` string, required: Company name
  - `events` TimelineEvent[], required: List of timeline events, sorted by date (newest first)
    - `event_type` string, required: Event type identifier
    - `date` string, date-time, required: Date when the event occurred
    - `title` string, required: Short human-readable title
    - `description` string, nullable: Additional event details
    - `person_name` string, nullable: Name of person involved (if applicable)
    - `company_name` string, nullable: Name of company involved (if applicable)
    - `cvr` string, nullable: CVR of related company (if applicable)
    - `ownership_percent` number, nullable: Ownership percentage for ownership events
    - `role` string, nullable: Role/function for role change events
    - `old_name` string, nullable: Previous company name (for name_changed events)
    - `new_name` string, nullable: New company name (for name_changed events)
    - `is_end_event` boolean: Whether this marks the end of something (e.g., director left)
    - `unit_number` integer, nullable: Participant unit number for person events (links to the participant page)
    - `details` object, nullable: Extra type-specific fields (e.g. financial figures for regnskab_published, tender title/buyer/value for tender_award)
  - `meta` object: Response metadata

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/companydata/apis/companydata-dk-api.md) · [All operations](https://skmtc.dev/companydata/apis/companydata-dk-api/llms.txt) · [OpenAPI document](https://skmtc.dev/companydata/apis/companydata-dk-api/revisions/1cc6c361ae64?raw)