Sign in

v1

latestSwagger 2.02026-07-17114752.0 KB

Retrieve a company.

get/company/v1/company

Query parameters

namestring

company name

addressstring

company address (you only need to specify the city)

registerIdstring

the ID of under which the company is registered, for example HRB 12345

registerCitystring

the city of the court where the company is registered, for example Hamburg

companyIdstring

internal company id (do not store this id in an external database, it may change over time)

fuzzyMatchboolean

true to find best match (similar name and nearby address)

registerKeystring

key that has been provided via the register uniqueKey field

historyboolean

true to include historical data

financialsboolean

true to include financial data

eventsboolean

true to include event data

{"stackTrail":"components:parameters:eventType:schema:items","oasType":"schema","type":"unknown"}

restrict which event types will be returned if events equals true

maxEventsinteger

maximum number of events to return

relationsboolean

true to include related company and person data. Note: For owners, only majority shareholders are included. For more owners, use the "owners" parameter instead.

ownersboolean

true to include all owners/shareholders (companies & persons) of the subject company

ownershipsboolean

true to include companies owned by the subject company.

representativesboolean

true to include legal representatives of the subject company (e.g., managing directors, board members).

alwaysResolveboolean

true to lookup current state of related company from database

sheetsboolean

true to include company financial sheets (balance, earnings)

extrasboolean

true to include extra company data provided by 3rd parties

output'json' | 'xml'

response format

Response

A successful response

idstring required

internal company id (do not store this id in an external database, it may change over time)

rawNamestring

May provide the raw name found in register sources before applying normalizations and spelling fixes

leistring

International Legal Entity Identifier (LEI)

euIdstring

European Unique Identifier (EUID)

elfCodestring

current entity legal form code according to ISO 20275

subjectstring

subject according to register filing (also called corporate object, purpose, Unternehmensgegenstand), possibly translated

originalSubjectstring

subject according to register filing (also called corporate object, purpose, Unternehmensgegenstand), in the original language

originalSubjectLangstring

original language of the subject

proxyPolicystring

rules for representation by legal representatives (e.g., signatory authority)

segmentCodesobject

each property (naics, isic, nace, wz, uksic) contains a list of segment codes in respective standard classification

northDataUrlstring

North data web page for this company

terminatedboolean

company has been terminated

status'active' | 'liquidation' | 'terminated'

current status of the company, where liquidation is the intermediate state before the final removal from the register (=terminated)

blockedboolean

company data should not be publicly on the Internet because of a request for privacy protection

lastUpdateTimestring date-time

last time this company was updated