---
canonical_url: "https://docs.composio.dev/toolkits/virkly"
markdown_url: "https://docs.composio.dev/toolkits/virkly.md"
product: "platform"
version: null
last_updated: null
---

# Virkly

Virkly provides Danish company, person, industry, financial, and business-change data through its official REST API.

- **Category:** business intelligence
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 26
- **Triggers:** 0
- **Slug:** `VIRKLY`
- **Version:** 00000000_00

## Tools

### Autocomplete Company Names

**Slug:** `VIRKLY_AUTOCOMPLETE_COMPANY_NAMES`

Return up to six Virkly company-name suggestions for a text prefix.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | string | Yes | Company-name prefix (1-255 characters); fewer than two characters returns no suggestions. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Find Companies by Slug

**Slug:** `VIRKLY_FIND_COMPANIES_BY_SLUG`

Resolve a Virkly URL slug to matching Danish companies. Returns one match when the slug uniquely identifies a company and all candidates when it is ambiguous.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `slug` | string | Yes | Virkly company URL slug. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Companies Batch

**Slug:** `VIRKLY_GET_COMPANIES_BATCH`

Get curated records for multiple Danish companies by CVR number in one read-only request. Each returned company consumes one monthly quota unit.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cvrs` | array | Yes | Distinct 8-digit Danish CVR numbers to look up. Free and Pocket plans accept at most 10; API and Custom plans accept at most 100. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Company

**Slug:** `VIRKLY_GET_COMPANY`

Get a Danish company's curated identity, status, address, industry, employee, production-unit, and contact data by CVR number.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cvr` | string | Yes | Company's 8-digit Danish CVR number, or a Virkly {slug}-{cvr} identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Company Capital

**Slug:** `VIRKLY_GET_COMPANY_CAPITAL`

Get a Danish company's share-capital history, changes, and implied valuations by CVR number.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cvr` | string | Yes | Company's 8-digit Danish CVR number, or a Virkly {slug}-{cvr} identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Company Capital History

**Slug:** `VIRKLY_GET_COMPANY_CAPITAL_HISTORY`

Get capital increases parsed from a Danish company's registration notices, including subscription price, investment, and implied valuation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cvr` | string | Yes | Company's 8-digit Danish CVR number, or a Virkly {slug}-{cvr} identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Company Details

**Slug:** `VIRKLY_GET_COMPANY_DETAILS`

Get a Danish company's registered share capital, purpose, articles date, and signatory rule by CVR number.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cvr` | string | Yes | Company's 8-digit Danish CVR number, or a Virkly {slug}-{cvr} identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Company Financials

**Slug:** `VIRKLY_GET_COMPANY_FINANCIALS`

Get annual-report key figures for a Danish company, optionally restricted to one fiscal year. Financial figures may be null when an annual report does not state them.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cvr` | string | Yes | Company's 8-digit Danish CVR number, or a Virkly {slug}-{cvr} identifier. |
| `year` | integer | No | Fiscal year to return; omit for latest and historical figures. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Company Full Data

**Slug:** `VIRKLY_GET_COMPANY_FULL_DATA`

Get a broad company-research bundle with the company record, people, former roles and owners, same-address companies, legal details, capital history, changes, financials, auditors, and public-register trust signals.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cvr` | string | Yes | Company's 8-digit Danish CVR number, or a Virkly {slug}-{cvr} identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Industry

**Slug:** `VIRKLY_GET_INDUSTRY`

Get statistics for a Danish DB07 industry, including top cities and employee ranges.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `code` | string | Yes | DB07 industry code (branchekode). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Person

**Slug:** `VIRKLY_GET_PERSON`

Get a Danish business participant's company roles, aggregate role statistics, and professional network by ERST participant number.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `enheds_nummer` | integer | Yes | ERST participant number returned by company people or search results. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Recent Company Changes

**Slug:** `VIRKLY_GET_RECENT_COMPANY_CHANGES`

Get a grouped snapshot of recent changes across Danish companies, keyed by change type.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of recent changes considered (1-200). |
| `per_type` | integer | No | Maximum number of changes returned for each change type (1-30). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Bankruptcies

**Slug:** `VIRKLY_LIST_BANKRUPTCIES`

List non-personal Danish companies declared bankrupt in the last 7 or 30 days, newest first, by documented provider page number.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `days` | string ("7" | "30") | No | Bankruptcy lookback window in days. |
| `page` | integer | No | Provider page number; each page contains up to 50 bankruptcies. |
| `industry_code` | string | No | Only return this DB07 industry code. Industry counts still cover the whole lookback window. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Company Annual Reports

**Slug:** `VIRKLY_LIST_COMPANY_ANNUAL_REPORTS`

List a company's published annual reports with accounting periods and PDF, XML, and XHTML document links.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cvr` | string | Yes | Company's 8-digit Danish CVR number, or a Virkly {slug}-{cvr} identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Company Changes

**Slug:** `VIRKLY_LIST_COMPANY_CHANGES`

Poll the daily global company status and name change feed, returning one page and an opaque continuation cursor.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum changes in this page (1-500). |
| `since` | string | No | Start timestamp for the first page. Defaults to 24 hours ago and is ignored when cursor is set. Free keys can start at most 7 days ago. |
| `cursor` | string | No | Opaque next_cursor from the previous page. Omit for the first page and pass it back unchanged. |
| `change_types` | string | No | Comma-separated change types; each value must be status or name. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Company History

**Slug:** `VIRKLY_LIST_COMPANY_HISTORY`

List recorded status, name, address, industry, capital, legal-form, employee, and auditor changes for one Danish company.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cvr` | string | Yes | Company's 8-digit Danish CVR number, or a Virkly {slug}-{cvr} identifier. |
| `limit` | integer | No | Maximum number of newest-first changes. Virkly documents a default of 50. |
| `change_type` | string | No | Only return changes of this type. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Company Participations

**Slug:** `VIRKLY_LIST_COMPANY_PARTICIPATIONS`

List roles a Danish company holds in other companies, including ownership and active-role statistics.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cvr` | string | Yes | Company's 8-digit Danish CVR number, or a Virkly {slug}-{cvr} identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Company People

**Slug:** `VIRKLY_LIST_COMPANY_PEOPLE`

List a company's management, board members, and owners, including person identifiers usable for person research.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cvr` | string | Yes | Company's 8-digit Danish CVR number, or a Virkly {slug}-{cvr} identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Company Production Units

**Slug:** `VIRKLY_LIST_COMPANY_PRODUCTION_UNITS`

List a Danish company's production units with P-number, address, industry, and employee data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cvr` | string | Yes | Company's 8-digit Danish CVR number, or a Virkly {slug}-{cvr} identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Industries

**Slug:** `VIRKLY_LIST_INDUSTRIES`

List all DB07 industries with their codes, descriptions, and company counts for classification and search segmentation.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Industry Companies

**Slug:** `VIRKLY_LIST_INDUSTRY_COMPANIES`

List Danish companies in a DB07 industry, one page at a time.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `code` | string | Yes | DB07 industry code (branchekode). |
| `sort` | string | No | Provider sort expression; Virkly documents no enum. |
| `limit` | integer | No | Maximum companies in this page (1-100). |
| `cursor` | string | No | Opaque next_cursor from the previous page; omit for the first page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Persons

**Slug:** `VIRKLY_LIST_PERSONS`

List people in Virkly's Danish business register. An optional name filter returns live-register matches with country and address-protection data when supplied.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Optional person-name filter (2-255 characters). |
| `limit` | integer | No | Maximum number of people in this page (1-100). |
| `cursor` | string | No | Opaque next_cursor from the previous page. Omit for the first page and pass it back unchanged. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Top Industries

**Slug:** `VIRKLY_LIST_TOP_INDUSTRIES`

List Danish DB07 industries from Virkly's top-industries collection.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Companies and People

**Slug:** `VIRKLY_SEARCH_COMPANIES_AND_PEOPLE`

Search indexed companies and people by text, or segment companies by industry, municipality, or founding date. Legal form and other filters narrow an established search; returns one page and a continuation cursor.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `city` | string | No | City name used to narrow company results. |
| `sort` | string ("relevance" | "name" | "newest") | No | Result order. Segment search without query requires newest. |
| `limit` | integer | No | Maximum company results in this page (1-100). |
| `query` | string | No | Company name, CVR number, or person name (2-255 characters). Omit only for segment search. |
| `cursor` | string | No | Opaque continuation cursor returned by a previous call. It retains the original search filters, so pass it back unchanged. |
| `status` | string ("active" | "dissolved" | "all") | No | Company status to include. |
| `founded_to` | string | No | Include companies founded on or before this date; must not precede founded_from. |
| `postal_code` | integer | No | Four-digit Danish postal code used to narrow company results. |
| `company_type` | string | No | Legal company type used only to narrow company results; it cannot establish a queryless segment. |
| `founded_from` | string | No | Include companies founded on or after this date. |
| `municipality` | string | No | Municipality name used to narrow results or define a segment; matching is case-insensitive. |
| `industry_code` | string | No | DB07 industry code used to narrow results or define a segment. |
| `include_protected` | boolean | No | In segment mode only, include companies marked reklamebeskyttet; Danish law restricts unsolicited marketing to them. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Companies by Name

**Slug:** `VIRKLY_SEARCH_COMPANIES_BY_NAME`

Search the live Danish CVR register by company name and return one page with an opaque continuation cursor.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Company name to search for in the live Danish CVR register. |
| `limit` | integer | No | Maximum companies in this page (1-100). |
| `cursor` | string | No | Opaque next_cursor from the previous page; omit for the first page. |
| `status` | string ("active" | "ceased" | "all") | No | Company status filter. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Persons

**Slug:** `VIRKLY_SEARCH_PERSONS`

Search people by name in the live Danish CVR register.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Person name to search for (2-255 characters). |
| `limit` | integer | No | Maximum number of people in this page (1-100). |
| `cursor` | string | No | Opaque next_cursor from the previous page. Omit for the first page and pass it back unchanged. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |
