v1

latestSwagger 2.02026-07-17114752.0 KB

power search: supports geo and financial criteria

get/search/v1/power

Query parameters

keywordsstring

keywords to match in the company's subject

addressstring

address or geo coordinates

maxDistanceKmnumber double

maximum distance from given address

legalFormstring

list of legal forms and legal form families. Valid values can be retrieved dynamically from the /reference/v1/overview endpoint (see legalForms and legalFormFamilies).

segmentCodeStandardstring

name of the segment code standard to use. Valid values can be retrieved dynamically from the /reference/v1/overview endpoint.

segmentCodesstring

list of segment codes Valid values can be retrieved dynamically from the /reference/v1/segmentCodes endpoint.

indicatorIdstring[]

list of indicator ids for performance filtering. Valid values can be retrieved dynamically from the /reference/v1/overview endpoint.

lowerBoundnumber[]

list of lower bounds for performance filterings (see user guide)

upperBoundnumber[]

list of upper bounds for performance filterings (see user guide)

lowerBoundUnitstring[]

list of lower bound units. Only required for currencies different from EUR

upperBoundUnitstring[]

list of upper bound units. Only required for currencies different from EUR

eventsboolean

true to include event data

eventTypestring[]

list of event types for event filtering. Valid values can be retrieved dynamically from the /reference/v1/overview endpoint.

minDatestring[]

list of minimum dates for event filterings (see user guide)

maxDatestring[]

list of maximum dates for event filterings (see user guide)

countriesstring

list of country ISO codes to restrict result set (empty to retrieve all countries). Valid values can be retrieved dynamically from the /reference/v1/overview endpoint.

statusstring

list of valid statuses (active, terminated, liquidation). Valid values can be retrieved dynamically from the /reference/v1/overview endpoint.

historyboolean

true to include historical data

financialsboolean

true to include financial data

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

posstring

if additional results shall be downloaded, set this to the value of the nextPos attribute of the previous response

censorboolean

should be set when presenting the content on a public website

limitinteger

maximum number of items to return

output'json' | 'xml'

response format

Response

A successful response

censoredboolean

true if results have been omitted because of censoring

offsetinteger

offset of result array in all results

nextOffsetinteger

offset to retrieve next batch of results

nextPosstring

position to retrieve next batch of results

totalinteger

total number of results (usually, this number is not available, unfortunately)