Unternehmensprofil von North Data. 1 Credit pro Aufruf.
query akzeptiert eine Profil-URL, eine numerische North-Data-Id (mindestens 10 Ziffern) oder einen Firmennamen. Ein Name öffnet den ersten Suchtreffer. countries steuert diese Suche.
Das Objekt enthält Firma, Status, Adresse, Register, Kapital, Branchencodes, die letzten Finanzkennzahlen, veröffentlichte Kontakte und die Historie.
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
Beispiel (Name):
Maison Boinaud
Beispiel (Profil-URL):
https://www.northdata.com/Rolls-Royce%20plc,%20London/Companies%20House%2001003142
query ist Pflicht. Die erste Form, die das Unternehmen erkennt, wird verwendet.
| Form |
Beispiel |
Wirkung |
| Profil-URL |
https://www.northdata.com/Rolls-Royce%20plc,%20London/Companies%20House%2001003142 |
Der Host kommt aus der URL. Der Pfad liefert Register, interne Id oder Name und Ort |
| North-Data-Id |
5854348650 |
10 Ziffern oder mehr. Geladen auf dem Host aus domain |
| Name |
Maison Boinaud |
Der erste Unternehmensvorschlag wird geöffnet. countries und domain gelten für diese Suche |
Eine Suggest-URL ergibt 400. Ein anderer Host ergibt 400. Ein leerer Wert ergibt 400. Trifft der Name eine Person und kein Unternehmen, kommt 404.
countries gilt nur, wenn query ein Name ist. Dieselben Codes wie bei der Suche: FR, FR,DE oder FR|DE. Ein ungültiger Code ergibt 400.
domain ist fr (Standard), com / en oder de. Bei einer URL wird es ignoriert.
| Parameter |
Typ |
Pflicht |
Beschreibung |
query |
string |
ja |
Profil-URL, North-Data-Id (mindestens 10 Ziffern) oder Name |
countries |
string |
nein |
ISO-Alpha-2. Nur wenn query ein Name ist |
domain |
string |
nein |
fr, com oder de. Bei einer URL ignoriert. Standard 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 |
- Erlaubte Hosts:
www.northdata.fr, www.northdata.com, www.northdata.de. Jeder andere Host liefert 400.
- Ein unbekanntes Unternehmen liefert
404.
financials enthält nur die letzte veröffentlichte Periode.persons wiederholt Historieneinträge der Kategorie 9.
| Code |
Bedeutung |
400 |
Leere Anfrage oder Host außerhalb von North Data |
403 |
Blockiert |
404 |
Unternehmen nicht gefunden |
500 |
Abruf fehlgeschlagen |
