Skip to main content
OpenRegister logo
  • Category: business intelligence
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 10
  • Triggers: 0
  • Slug: OPEN_REGISTER
  • Version: 20261101_00

Tools

Slug: OPEN_REGISTER_GET_COMPANY_DATARead 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

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

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: OPEN_REGISTER_GET_CREDIT_USAGECheck whether the connected OpenRegister account is paid, along with included and used credits, remaining balance, overage, and reset time. This request costs 0 credits.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: OPEN_REGISTER_GET_DOCUMENTFetch 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

string
OpenRegister company ID. Required only when document_source is realtime.
string
Stored document ID from company document metadata. Required only when document_source is stored.
string ("realtime" | "stored")
required
Retrieval mode: realtime fetches a document category for a company; stored retrieves an existing document ID.
string ("current_printout" | "chronological_printout" | "historical_printout" | "structured_information" | "shareholder_list" | "articles_of_association")
Official document category. Required only when document_source is realtime.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: OPEN_REGISTER_GET_INSOLVENCYGet 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

string
required
Insolvency proceeding ID returned by insolvency search.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: OPEN_REGISTER_GET_PERSON_DATARead a person’s profile and management positions or the companies in which they hold ownership stakes. Each request costs 10 credits.

Input Parameters

string ("profile" | "holdings")
Person section to retrieve: profile and management positions, or ownership holdings.
string
required
OpenRegister person UUID returned by person search.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: OPEN_REGISTER_LIST_MONITORSList 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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: OPEN_REGISTER_LOOKUP_COMPANY_BY_URLResolve a fully qualified company website URL to its OpenRegister company ID and available contact details. Each lookup costs 10 credits.

Input Parameters

string
required
Fully qualified HTTP or HTTPS URL of the company website to resolve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: OPEN_REGISTER_SEARCH_COMPANIESFind companies by name or structured criteria using autocomplete for a fast 1-credit lookup. Advanced search requires a Pro plan or above and supports filters, location, and paginated results at 10 credits per page.

Input Parameters

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

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: OPEN_REGISTER_SEARCH_INSOLVENCIESSearch 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

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

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: OPEN_REGISTER_SEARCH_PEOPLESearch natural persons by name, birth date, city, or active status. Each returned page costs 10 credits.

Input Parameters

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

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not