Company profile from North Data. 1 credit per call.
query accepts a profile URL, a numeric North Data id (10 digits or more), or a company name. A name opens the first search hit. Use countries to steer that lookup.
The object includes the legal name, status, address, register, capital, industry codes, the latest financial indicators, published contact extras, and the history timeline.
GET https://api.piloterr.com/v2/northdata/company?query=https://www.northdata.com/Rolls-Royce%20plc,%20London/Companies%20House%2001003142
GET https://api.piloterr.com/v2/northdata/company?query=Maison%20Boinaud&countries=FR
Example (company name):
Maison Boinaud
Example (profile URL):
https://www.northdata.com/Rolls-Royce%20plc,%20London/Companies%20House%2001003142
query is required. The first form that identifies the company is used.
| Form |
Example |
What happens |
| Profile URL |
https://www.northdata.com/Rolls-Royce%20plc,%20London/Companies%20House%2001003142 |
Host comes from the URL. The path supplies the register, the internal id, or the name and city |
| North Data id |
5854348650 |
10 digits or more. Loaded on the host from domain |
| Company name |
Maison Boinaud |
The first company suggestion is opened. countries and domain apply to that lookup |
A suggest URL returns 400. Another host returns 400. An empty value returns 400. If the name matches a person and not a company, the call returns 404.
countries is used only when query is a name. Same codes as search: FR, FR,DE or FR|DE. A bad code returns 400.
domain is fr (default), com / en, or de. It is ignored when query is a URL.
| Parameter |
Type |
Required |
Description |
query |
string |
yes |
Profile URL, North Data id (10 digits or more), or company name |
countries |
string |
no |
ISO alpha-2. Used only when query is a name |
domain |
string |
no |
fr, com or de. Ignored when query is a URL. Default fr |
| Field |
Type |
Description |
company_id |
string | null |
North Data id |
name |
string | null |
Legal name |
legal_form |
string | null |
Legal form (SAS, plc, …) |
status |
string | null |
active, liquidation or terminated |
url |
string | null |
Canonical profile URL |
subject |
string | null |
Activity, in the site language |
original_subject |
string | null |
Activity in the source language |
original_subject_language |
string | null |
Language of original_subject |
risk_level |
string | null |
North Data risk flag |
lei / eu_id / elf_code |
string | null |
Identifiers when published |
last_update_time |
string | null |
ISO timestamp |
address |
object |
Street, postal code, city, state, country, formatted line, latitude, longitude |
register |
object |
id, city, country, unique_key |
capital |
object | null |
Latest capital: value, display, unit, date |
segment_codes |
object |
nace, naf, isic, naics, uksic and the 2025 variants |
financials[] |
array |
Latest period only: id, name, value, display, unit, date |
extras[] |
array |
Published contacts (phone, url, email, vatId) |
events[] |
array |
Timeline: date, category, description, url |
persons[] |
array |
Timeline rows whose category is 9 |
former_names[] |
array |
Previous names |
other_registers[] |
array |
Other register numbers |
filings[] |
array |
LEI, SIRET and similar filings |
- Accepted hosts:
www.northdata.fr, www.northdata.com, www.northdata.de. Any other host returns 400.
- An unknown company returns
404.
financials is the latest published period only.persons repeats history rows with category 9.
| Code |
Meaning |
400 |
Missing query or a host outside North Data |
403 |
Blocked |
404 |
Company not found |
500 |
Fetch failed |
