API-dokumentation

API-endepunkter

Komplet reference for alle tilgængelige endepunkter

Tilgængelige endepunkter

Endepunkt	Beskrivelse
GET `/v1/search`	Search for companies by name or CVR number
GET `/v1/companies/{cvr}`	Retrieve complete company information using the 8-digit CVR number
GET `/v1/companies/{cvr}/people`	Retrieve key people (directors, board members, owners) for a company
GET `/v1/companies/{cvr}/financials`	Retrieve financial data for a company including latest financials and historical data

GET

/v1/search

Search Companies

Search for companies by name or CVR number

Query Parameters

Parameter	Type	Required	Description
`q`	string	Yes	Search query - company name or CVR number (min 2 characters)
`limit`	integer	No	Results per page (default: 20, max: 100)
`offset`	integer	No	Pagination offset (default: 0)

Example Request

curl -X GET "https://virkly.io/v1/search?q=Novo%20Nordisk&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{
  "results": [
    {
      "cvr": "24256790",
      "name": "NOVO NORDISK A/S",
      "status": "active",
      "address": {
        "street": "Novo Allé 1",
        "postalCode": "2880",
        "city": "Bagsværd"
      },
      "industry": {
        "code": "211000",
        "description": "Fremstilling af farmaceutiske råvarer"
      }
    }
  ],
  "total": 127,
  "limit": 10,
  "offset": 0
}

Notes

Results are sorted by relevance score
The query parameter supports both company names and CVR numbers
CVR numbers are returned as zero-padded strings (e.g., "00123456")

GET

/v1/companies/{cvr}

Get Company by CVR

Retrieve complete company information using the 8-digit CVR number

Path Parameters

Parameter	Type	Required	Description
`cvr`	string	Yes	8-digit CVR number (e.g., 24256790)

Query Parameters

Parameter	Type	Required	Description
`expand`	string	No	Use "full" to include raw ERST data alongside curated response

Example Request

curl -X GET "https://virkly.io/v1/companies/24256790" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{
  "cvr": 24256790,
  "name": "NOVO NORDISK A/S",
  "status": "active",
  "isActive": true,
  "founded": "1989-03-24",
  "age": 36,
  "companyType": "Aktieselskab",
  "companyTypeCode": "A/S",
  "address": {
    "street": "Novo Allé",
    "houseNumber": 1,
    "letter": null,
    "floor": null,
    "door": null,
    "zipCode": 2880,
    "city": "Bagsværd",
    "municipality": "Gladsaxe",
    "full": "Novo Allé 1, 2880 Bagsværd"
  },
  "industry": {
    "code": "211000",
    "description": "Fremstilling af farmaceutiske råvarer"
  },
  "employees": {
    "year": 2023,
    "count": 45000,
    "range": "1000+"
  },
  "productionUnits": [
    { "pNumber": 1003369285 },
    { "pNumber": 1021548763 }
  ],
  "contact": {
    "phone": [],
    "email": [],
    "website": []
  },
  "lastUpdated": "2025-01-15T10:30:00.000Z"
}

Notes

Employee data may be null if not available from ERST
Contact arrays are often empty - ERST data frequently lacks contact info
Use ?expand=full to get raw ERST data for power users

GET

/v1/companies/{cvr}/people

Get Key People

Retrieve key people (directors, board members, owners) for a company

Path Parameters

Parameter	Type	Required	Description
`cvr`	string	Yes	8-digit CVR number

Example Request

curl -X GET "https://virkly.io/v1/companies/24256790/people" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{
  "cvr": "24256790",
  "companyName": "NOVO NORDISK A/S",
  "people": [
    {
      "name": "Lars Fruergaard Jørgensen",
      "role": "Direktør",
      "roleType": "director",
      "since": "2017-01-01",
      "active": true
    },
    {
      "name": "Helge Lund",
      "role": "Formand",
      "roleType": "board_chairman",
      "since": "2018-03-22",
      "active": true
    },
    {
      "name": "Karsten Munk Knudsen",
      "role": "Bestyrelsesmedlem",
      "roleType": "board_member",
      "since": "2020-03-26",
      "active": true
    }
  ],
  "lastUpdated": "2025-01-15T10:30:00.000Z"
}

Notes

Only currently active people are returned by default
Role types include: director, board_chairman, board_member, owner, auditor
Some smaller companies may have limited personnel data

GET

/v1/companies/{cvr}/financials

Get Financial Data

Retrieve financial data for a company including latest financials and historical data

Path Parameters

Parameter	Type	Required	Description
`cvr`	string	Yes	8-digit CVR number

Query Parameters

Parameter	Type	Required	Description
`year`	integer	No	Specific fiscal year to retrieve (default: latest available)

Example Request

curl -X GET "https://virkly.io/v1/companies/24256790/financials" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{
  "cvr": "24256790",
  "companyName": "NOVO NORDISK A/S",
  "latestFinancials": {
    "year": 2023,
    "periodStart": "2023-01-01",
    "periodEnd": "2023-12-31",
    "revenue": 232261000000,
    "grossProfit": 191845000000,
    "operatingProfit": 99856000000,
    "netProfit": 83683000000,
    "totalAssets": 380592000000,
    "equity": 170456000000,
    "currency": "DKK"
  },
  "historicalData": [
    {
      "year": 2022,
      "periodStart": "2022-01-01",
      "periodEnd": "2022-12-31",
      "revenue": 176954000000,
      "grossProfit": 146822000000,
      "operatingProfit": 69651000000,
      "netProfit": 55526000000,
      "totalAssets": 304858000000,
      "equity": 129844000000,
      "currency": "DKK"
    }
  ],
  "employees": {
    "year": 2023,
    "count": 61200,
    "range": "1000+"
  },
  "lastUpdated": "2025-01-15T10:30:00.000Z"
}

Notes

Financial data is only available for companies that file annual reports
latestFinancials contains the most recent fiscal year data
historicalData contains an array of previous years when available
Some fields may be null if not reported in annual filings
Private companies may have limited financial disclosure