# North Data Company ## Overview | Property | Value | |----------|-------| | **Status** | active | | **Method** | `GET` | | **Endpoint** | `/v2/northdata/company` | | **Base URL** | `https://api.piloterr.com` | | **Credit Cost** | 1 credit per call | | **Documentation** | https://www.piloterr.com/library/northdata-company | ## Description North Data company profile: register, address, financials and history (1 credit). ## Authentication - **Key Name:** `x-api-key` - **Location:** HTTP Header - **Get an API key:** https://app.piloterr.com/register ## Example Request ```bash curl --location --request GET 'https://api.piloterr.com/v2/northdata/company' \ --header 'Content-Type: application/json' \ --header 'x-api-key: YOUR_API_KEY' ``` ## Example Response ### Rolls-Royce plc ```json { "lei": "X57JK1U580XATGR67572", "url": "https://www.northdata.com/Rolls-Royce%20plc,%20London/Companies%20House%2001003142", "name": "Rolls-Royce plc", "eu_id": null, "events": [ { "url": "https://www.northdata.com/?id=6137794862", "date": "1971-02-23", "category": 1, "description": "Registration" }, { "url": "https://www.northdata.com/?id=6228341741846528", "date": "1995-01-01", "category": 1, "description": "Registration France" }, { "url": "https://www.northdata.com/?id=6137794862", "date": "1978-01-02", "category": 2, "description": "Legal form: Ltd. → plc" }, { "url": "https://www.northdata.com/?id=6137794862", "date": "1978-01-02", "category": 2, "description": "Name: Rolls-Royce plc" } ], "extras": [ { "id": "phone", "name": "Phone", "value": "+44 07770442315" }, { "id": "url", "name": "Website", "value": "https://www.rolls-royce.com" }, { "id": "email", "name": "Email", "value": "enquiries@rolls-royce.com" } ], "status": "active", "address": { "city": "London", "state": null, "street": "90 York Way", "country": "GB", "latitude": 51.5349626, "formatted": "90 York Way, Kings Place, London N1 9FX, United Kingdom", "longitude": -0.1217676933974402, "postal_code": "N1 9FX" }, "capital": { "id": "Capital", "date": "2016-06-13", "name": "Base/share capital", "unit": "GBP", "value": 326199301.6, "display": "£326.2M" }, "filings": [ { "id": "Siret 42218357400017", "name": "Siret 42218357400017", "type": "Siret", "source": null }, { "id": "X57JK1U580XATGR67572", "name": "X57JK1U580XATGR67572", "type": "Lei", "source": "Lei" } ], "persons": [ { "url": "https://www.northdata.com/?id=6513855692", "date": "2026-03-24", "category": 9, "description": "Director Alex Martin" }, { "url": "https://www.northdata.com/?id=6513855692", "date": "2023-08-04", "category": 9, "description": "Director Jordan Lee" } ], "subject": "Aircraft and spacecraft repair and maintenance", "elf_code": "B6ES", "register": { "id": "01003142", "city": null, "country": "GB", "unique_key": "GB_01003142" }, "company_id": "5854348650", "financials": [ { "id": "Capital", "date": "2025-12-31", "name": "Base/share capital", "unit": "GBP", "value": 326199301.6, "display": "£326.2M" }, { "id": "BalanceTotal", "date": "2025-12-31", "name": "Total assets", "unit": "GBP", "value": 40308, "display": "£40,308" }, { "id": "Earnings", "date": "2025-12-31", "name": "Earnings", "unit": "GBP", "value": 5836, "display": "£5,836.00" }, { "id": "Revenue", "date": "2025-12-31", "name": "Revenue", "unit": "GBP", "value": 21207, "display": "£21,207" }, { "id": "ReturnOnSales", "date": "2025-12-31", "name": "Return on sales", "unit": "%", "value": 27.51921535342104, "display": "27.5%" }, { "id": "Equity", "date": "2025-12-31", "name": "Equity", "unit": "GBP", "value": 4977, "display": "£4,977.00" } ], "legal_form": "plc", "risk_level": "GREEN", "former_names": [ { "date": "1977-12-31", "name": "Rolls-Royce (1971) Ltd.", "legal_form": "Ltd." } ], "segment_codes": { "naf": [], "isic": [ "2513", "2592", "2811" ], "nace": [ "25.30", "25.62", "28.11" ], "naics": [ "332313", "332410", "339910", "332710" ], "uksic": [ "25.30", "25.62", "28.11" ], "naf_2025": [], "nace_2025": [ "25.21", "25.53", "28.11" ] }, "other_registers": [ { "city": null, "date": "2025-12-06", "country": "FR", "unique_key": "FR_422183574", "register_id": "422183574" }, { "city": null, "date": "2022-11-11", "country": "NO", "unique_key": "NO_974230151", "register_id": "974230151" } ], "last_update_time": "2026-10-27T17:03:32.364Z", "original_subject": "Aircraft and spacecraft repair and maintenance", "original_subject_language": "en" } ``` ## Documentation ## Overview 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. ## Quickstart ``` 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 ``` ## `query` **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. ## Parameters | 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` | ## Response fields | 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 | ## Notes - 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`. ## Error codes | Code | Meaning | |---|---| | `400` | Missing query or a host outside North Data | | `403` | Blocked | | `404` | Company not found | | `500` | Fetch failed | ## Related endpoints - [North Data Search](https://www.piloterr.com/library/northdata-search)