Retrieve company data
This endpoint allows you to retrieve detailed information about a specific company.
You need to provide the country code, company number, and the desired data points.
Available data points are:
- company_profile: Basic company information
- legal_representatives: Information about company officers
- ultimate_beneficial_owners: Information about beneficial owners
- available_documents: List of available official documents
You can also request specific documents by providing their IDs in the “documents” field. These can be either random IDs from the available_documents data point, or stable quick access IDs for certain documents.
The response will include the requested information based on the specified data points and documents.
Authorizations
Body
Country code, which can be an ISO country code, or for the United States, a combination of "US" and the state code (e.g., "US-CA" for California).
AE, AT, AU, BE, BL, BR, CH, CN, CY, DE, DK, EE, ES, FI, FR, GF, GG, GI, GP, GR, IN, IT, JE, JP, LT, LU, LV, MK, MQ, MT, MY, NC, NL, NO, NZ, PF, PM, PT, RE, SE, SG, SI, TW, UK, US, US-AK, US-AL, US-AZ, US-CA, US-CO, US-CT, US-DC, US-DE, US-FL, US-IA, US-ID, US-IL, US-IN, US-KY, US-LA, US-MD, US-ME, US-MN, US-MO, US-MS, US-MT, US-NC, US-ND, US-NH, US-NJ, US-NM, US-NV, US-NY, US-OH, US-OK, US-PA, US-RI, US-SC, US-SD, US-TN, US-TX, US-VA, US-WA, US-WI, US-WV, US-WY, WF, YT The company number. In some countries, this might be a concatenation of the registry and city (e.g., in Germany: "Augsburg HRB 34617"). The search function will always return a usable company number. Check the documentation to see which number format is used for each country.
The data points to retrieve. Available data points are: company_profile, legal_representatives, ultimate_beneficial_owners, available_documents.
company_profile, legal_representatives, ultimate_beneficial_owners, available_documents The document ids to retrieve. These can be either random ids obtained from the available_documents return, or in some cases, stable quick access ids like "uncertified_trade_register_extract" or "last_available_financial_statement". Stable ids enable quick access to specific documents without querying available_documents first. Refer to our country coverage documentation to check which quick access ids are available for each country.
Response
The main profile information of the company, including, if available, details such as name, registration number, address, and other core data.
The ultimate beneficial owners of the company, including, if available, their name, nationality, and other relevant details.
The legal representatives of the company, which can be either natural persons (individuals) or legal entities (companies). This includes, if available, their name, nationality, and other relevant details.
Indicates the status of data points and documents associated with the company. It states if the data has been retrieved, if a job is in progress for asynchronous data, or if a job there was an error.