Ficha de empresa da North Data. 1 crédito por chamada.
query aceita um URL de ficha, um id numérico North Data (10 dígitos ou mais) ou um nome. Um nome abre o primeiro resultado. countries orienta essa pesquisa.
O objeto inclui denominação, estado, morada, registo, capital, códigos de atividade, os últimos indicadores, contactos publicados e o histórico.
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
Exemplo (nome):
Maison Boinaud
Exemplo (URL de ficha):
https://www.northdata.com/Rolls-Royce%20plc,%20London/Companies%20House%2001003142
query é obrigatório. Usa-se a primeira forma que identifica a empresa.
| Forma |
Exemplo |
Efeito |
| URL de ficha |
https://www.northdata.com/Rolls-Royce%20plc,%20London/Companies%20House%2001003142 |
O host vem do URL. O caminho traz o registo, o id interno, ou o nome e a cidade |
| Id North Data |
5854348650 |
10 dígitos ou mais. Carregado no host de domain |
| Nome |
Maison Boinaud |
Abre-se a primeira sugestão de empresa. countries e domain aplicam-se a essa pesquisa |
Um URL suggest devolve 400. Outro host devolve 400. Um valor vazio devolve 400. Se o nome corresponder a uma pessoa e não a uma empresa, a chamada devolve 404.
countries só se usa se query for um nome. Os mesmos códigos da pesquisa: FR, FR,DE ou FR|DE. Um código inválido devolve 400.
domain vale fr (predefinição), com / en ou de. Ignora-se se query for um URL.
| Parâmetro |
Tipo |
Obrigatório |
Descrição |
query |
string |
sim |
URL de ficha, id North Data (10 dígitos ou mais), ou nome |
countries |
string |
não |
ISO alpha-2. Só se query for um nome |
domain |
string |
não |
fr, com ou de. Ignorado se query for um URL. Predefinição 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 |
- Hosts aceites:
www.northdata.fr, www.northdata.com, www.northdata.de. Qualquer outro host devolve 400.
- Uma empresa desconhecida devolve
404.
financials guarda só o último exercício publicado.persons repete as linhas do histórico de categoria 9.
| Código |
Significado |
400 |
Pedido vazio ou host fora da North Data |
403 |
Bloqueado |
404 |
Empresa não encontrada |
500 |
Falha do pedido |
