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

# OpenRegister

OpenRegister provides structured German company, person, ownership, financial, insolvency, document, monitoring, and usage data.

- **Category:** business intelligence
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 10
- **Triggers:** 0
- **Slug:** `OPEN_REGISTER`
- **Version:** 20260812_00

## Tools

### Get Company Data

**Slug:** `OPEN_REGISTER_GET_COMPANY_DATA`

Read one company profile, financials, historical ownership, holdings, current owners, or UBOs. Operations cost 10-25 credits; realtime profile/owners cost 20 credits. Historical ownership polls only after unbilled HTTP 202 responses and stops at the first billable HTTP 200. Financial source URLs expire after about 30 minutes and should be used immediately.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `export` | boolean | No | Profile or owners only. Profile export omits sources; owners export skips processing documents that are not ready. |
| `realtime` | boolean | No | Profile or owners only. Fetch current Handelsregister data, increasing that operation's cost from 10 to 20 credits. |
| `data_type` | string ("profile" | "financials" | "historical_owners" | "holdings" | "owners" | "ubos") | No | Company section to retrieve: profile, financials, historical owners, holdings, current owners, or UBOs. |
| `company_id` | string | Yes | OpenRegister company ID returned by company search or URL lookup. |
| `best_available` | boolean | No | Owners only. Return best-effort AG/SE ownership data; cannot be combined with realtime. |
| `wait_for_completion` | boolean | No | Historical owners only. After an unbilled HTTP 202, poll every 30 seconds until data is ready or the deadline expires. |
| `poll_timeout_seconds` | integer | No | Historical owners only. Total polling deadline in seconds (30-600). |

#### 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 Credit Usage

**Slug:** `OPEN_REGISTER_GET_CREDIT_USAGE`

Check the connected OpenRegister account's plan, included and used credits, remaining balance, overage, and reset time. This request costs 0 credits.

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

**Slug:** `OPEN_REGISTER_GET_DOCUMENT`

Fetch an official Handelsregister document in real time for a company or retrieve a stored document by ID. Each request costs 10 credits. The tool returns document metadata and an ephemeral URL without downloading the file; use the URL immediately. Stored URLs are valid for 15 minutes, while the realtime URL expiry is not documented.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `company_id` | string | No | OpenRegister company ID. Required only when document_source is realtime. |
| `document_id` | string | No | Stored document ID from company document metadata. Required only when document_source is stored. |
| `document_source` | string ("realtime" | "stored") | Yes | Retrieval mode: realtime fetches a document category for a company; stored retrieves an existing document ID. |
| `document_category` | string ("current_printout" | "chronological_printout" | "historical_printout" | "structured_information" | "shareholder_list" | "articles_of_association") | No | Official document category. Required only when document_source is realtime. |

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

**Slug:** `OPEN_REGISTER_GET_INSOLVENCY`

Get one insolvency proceeding and its complete published event history, including linked entities, status, court, case dates, administration, distributions, and event-specific details. Costs 10 OpenRegister credits.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `insolvency_id` | string | Yes | Insolvency proceeding ID returned by insolvency search. |

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

**Slug:** `OPEN_REGISTER_GET_PERSON_DATA`

Read a person's profile and management positions or the companies in which they hold ownership stakes. Each request costs 10 credits.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data_type` | string ("profile" | "holdings") | No | Person section to retrieve: profile and management positions, or ownership holdings. |
| `person_id` | string | Yes | OpenRegister person UUID returned by person search. |

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

**Slug:** `OPEN_REGISTER_LIST_MONITORS`

List every company and person monitor for the connected OpenRegister account, including disabled monitors. This unpaginated read costs zero credits and was verified as available on a free account. It does not create, re-enable, or delete monitors.

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

### Look Up Company by URL

**Slug:** `OPEN_REGISTER_LOOKUP_COMPANY_BY_URL`

Resolve a fully qualified company website URL to its OpenRegister company ID and available contact details. Each lookup costs 10 credits.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | Fully qualified HTTP or HTTPS URL of the company website to resolve. |

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

**Slug:** `OPEN_REGISTER_SEARCH_COMPANIES`

Find companies by name or structured criteria. Use autocomplete for a fast 1-credit lookup, or advanced search for filters, location, and paginated results at 10 credits per page.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | string | No | Company name or free text. Required for autocomplete; advanced search requires this, at least one filter, or a location. |
| `filters` | array | No | Advanced-only company filters. Multiple filters are combined by the provider. |
| `location` | object | No | Advanced-only geographic center and optional radius in kilometers. |
| `per_page` | integer | No | Advanced-only results per page. OpenRegister documents no maximum. |
| `next_cursor` | string | No | Opaque cursor returned by an advanced search. Send it alone to continue the original search. |
| `search_mode` | string ("autocomplete" | "advanced") | No | Use autocomplete for a fast 1-credit name lookup, or advanced for structured filters, location, and pagination at 10 credits per 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 |

### Search Insolvencies

**Slug:** `OPEN_REGISTER_SEARCH_INSOLVENCIES`

Search German insolvency proceedings by free text or structured debtor, proceeding, status, date, company, or person criteria. Returns one page at a time; each page costs 10 OpenRegister credits.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | string | No | Free text matched against debtor names, case numbers, administrator names, and courts. Provide this or at least one filter. |
| `filters` | array | No | Structured insolvency filters. Provide these or a free-text query. |
| `per_page` | integer | No | Results to return on this page. OpenRegister documents no maximum. |
| `next_cursor` | string | No | Opaque cursor from a previous response. It restores the original query, filters, and page size. |

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

**Slug:** `OPEN_REGISTER_SEARCH_PEOPLE`

Search natural persons by name, birth date, city, or active status. Each returned page costs 10 credits.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | string | No | Person name or free text. Provide this or at least one filter on the first page. |
| `filters` | array | No | Structured person filters. Multiple filters are combined by the provider. |
| `per_page` | integer | No | Results to return on this page. OpenRegister documents no maximum. |
| `next_cursor` | string | No | Opaque cursor from a previous response. Send it alone to continue the same search. |

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