L'API v1.
France, par SIREN et SIRET.

Votre premier appel

L'adresse de base est https://companies.jsonpage.com. Une clé API est nécessaire pour les routes de consultation. Les exemples ci-dessous utilisent des identifiants fictifs.

Avec cURL

curl "https://companies.jsonpage.com/v1/companies/123456789" \
  -H "X-API-Key: $COMPANIES_API_KEY"

Avec JavaScript côté serveur

const response = await fetch(
  "https://companies.jsonpage.com/v1/companies/123456789",
  { headers: { "X-API-Key": process.env.COMPANIES_API_KEY } }
);

if (!response.ok) throw new Error(`Companies API: ${response.status}`);
const company = await response.json();

Remplacez l'identifiant fictif par un SIREN réel dans votre application.

Deux recherches exactes

France

France

Frankrijk

Frankreich

curl "https://companies.jsonpage.com/v1/companies/552100554" \
  -H "X-API-Key: $COMPANIES_API_KEY"

{
  "siren": "552100554",
  "diffusion_status": "O",
  "name": "PEUGEOT SA",
  "created_at": "1955-01-01",
  "administrative_status": "C",
  "activity_code": "70.10Z",
  "legal_category": "5699",
  "last_processed_at": "..."
}

curl "https://companies.jsonpage.com/v1/establishments/55210055400039" \
  -H "X-API-Key: $COMPANIES_API_KEY"

{
  "siret": "55210055400039",
  "siren": "552100554",
  "diffusion_status": "O",
  "name": "...",
  "address": "...",
  "head_office": false,
  "...": "..."
}

curl "https://companies.jsonpage.com/v1/metadata" \
  -H "X-API-Key: $COMPANIES_API_KEY"

{
  "source_date": "2026-10-01",
  "companies_count": "...",
  "establishments_count": "...",
  "...": "..."
}

Santé du service

Service health

Gezondheid van de dienst

Dienstzustand

curl "https://companies.jsonpage.com/health/live"

{ "status": "ok" }

curl "https://companies.jsonpage.com/health/ready"

{ "status": "ready", "...": "..." }

curl "https://companies.jsonpage.com/health/sources"

{
  "status": "ok",
  "checked_at": "...",
  "sources": [
    { "country": "FR", "name": "Registre officiel FR", "published_at": "2026-10-01", "status": "ok" },
    { "...": "..." }
  ]
}

Des champs faciles à exploiter

Réponse illustrative pour une entreprise. Les champs absents dans la source sont renvoyés à null.

{
  "siren": "123456789",
  "diffusion_status": "O",
  "name": "Entreprise Exemple",
  "created_at": "2020-01-01",
  "administrative_status": "A",
  "activity_code": "62.01Z",
  "legal_category": "5710",
  "last_processed_at": "2026-09-01T10:00:00"
}

Réponse illustrative pour un établissement. head_office vaut true pour le siège de l'entreprise.

Illustrative establishment response. head_office is true for the company's head office.

Illustratief antwoord voor een vestiging. head_office is true voor de hoofdzetel van de onderneming.

Beispielantwort für eine Niederlassung. head_office ist true für den Hauptsitz des Unternehmens.

{
  "siret": "12345678900012",
  "siren": "123456789",
  "diffusion_status": "O",
  "name": "Entreprise Exemple",
  "address": "1 RUE DE L'EXEMPLE 75001 PARIS",
  "created_at": "2020-01-01",
  "administrative_status": "A",
  "activity_code": "62.01Z",
  "head_office": true,
  "last_processed_at": "2026-09-01T10:00:00"
}

Données fictives. Le statut de diffusion P entraîne le masquage des noms et adresses protégés.

Gérer les réponses

{ "error": "rate_limit_exceeded" }

Le champ error vaut invalid_siren, invalid_siret, invalid_api_key, ip_not_allowed, not_found, rate_limit_exceeded, data_unavailable ou server_busy. Sur 429 et 503, l'en-tête Retry-After donne le délai d'attente en secondes.

The error field is invalid_siren, invalid_siret, invalid_api_key, ip_not_allowed, not_found, rate_limit_exceeded, data_unavailable or server_busy. On 429 and 503, the Retry-After header gives the delay to wait, in seconds.

Het veld error is invalid_siren, invalid_siret, invalid_api_key, ip_not_allowed, not_found, rate_limit_exceeded, data_unavailable of server_busy. Bij 429 en 503 geeft de header Retry-After de wachttijd in seconden.

Das Feld error hat den Wert invalid_siren, invalid_siret, invalid_api_key, ip_not_allowed, not_found, rate_limit_exceeded, data_unavailable oder server_busy. Bei 429 und 503 nennt der Header Retry-After die Wartezeit in Sekunden.

Débits : Gratuit 100/min, Standard 1 000/min, Pro sans plafond de forfait. Il n'y a pas de quota mensuel. Pour préserver la disponibilité, Pro a une limite d'usage raisonnable de 10 000 requêtes/min par compte.

Une intégration fiable

• Validez que vos SIREN ont 9 chiffres et vos SIRET 14 chiffres avant l'appel.
• Conservez la clé API côté serveur. Pour la changer, renouvelez-la : l'ancienne reste valable 24 heures.
• Sur 429 ou 503, réessayez après une attente progressive.
• Consultez /v1/metadata pour connaître la date des données servies.
• Respectez le statut de diffusion partielle P et les conditions d'utilisation des données.

Voir aussi la page SLA pour l'engagement de disponibilité du forfait Pro.

Métadonnées et source

Metadata and source

Metadata en bron

Metadaten und Quelle

Companies s'appuie sur le répertoire officiel des entreprises françaises et sur des informations réglementaires publiques. Jsonpage rassemble, contrôle, harmonise et enrichit ces informations pour offrir des fiches prêtes à l'emploi, avec des identifiants vérifiés et des statuts lisibles.

Companies relies on the official register of French companies and on public regulatory information. Jsonpage collects, checks, harmonises and enriches this information to offer ready-to-use records, with verified identifiers and readable statuses.

Companies steunt op het officiële register van Franse ondernemingen en op openbare reglementaire informatie. Jsonpage verzamelt, controleert, harmoniseert en verrijkt deze informatie om kant-en-klare fiches te bieden, met gecontroleerde nummers en duidelijke statussen.

Companies stützt sich auf das amtliche Verzeichnis der französischen Unternehmen und auf öffentliche regulatorische Informationen. Jsonpage sammelt, prüft, vereinheitlicht und ergänzt diese Informationen, um sofort nutzbare Datensätze mit geprüften Kennungen und verständlichen Status zu bieten.

Chaque réponse indique dans meta.sources la date des données utilisées, et l'état du service est consultable à tout moment.

Every response gives the date of the data used in meta.sources, and the service status can be checked at any time.

Elk antwoord vermeldt in meta.sources de datum van de gebruikte gegevens, en de status van de dienst is altijd te raadplegen.

Jede Antwort nennt in meta.sources das Datum der verwendeten Daten, und der Dienststatus ist jederzeit abrufbar.

GET /v1/metadata renvoie des informations sur les données servies, sous forme de chaînes de caractères : source_date, la date des données ; built_at et last_sync_at, des repères techniques de mise à disposition ; companies_count et establishments_count, le nombre d'entreprises et d'établissements.

GET /v1/metadata returns information about the data served, as strings: source_date, the date of the data; built_at and last_sync_at, technical availability markers; companies_count and establishments_count, the number of companies and establishments.

GET /v1/metadata geeft informatie over de geleverde gegevens terug, als tekenreeksen: source_date, de datum van de gegevens; built_at en last_sync_at, technische beschikbaarheidsmarkeringen; companies_count en establishments_count, het aantal ondernemingen en vestigingen.

GET /v1/metadata liefert Angaben zu den bereitgestellten Daten als Zeichenketten: source_date, das Datum der Daten; built_at und last_sync_at, technische Bereitstellungsmarken; companies_count und establishments_count, die Anzahl der Unternehmen und Niederlassungen.

curl "https://companies.jsonpage.com/v1/metadata" \
  -H "X-API-Key: $COMPANIES_API_KEY"

{
  "source_date": "2026-10-01",
  "built_at": "2026-10-02T03:10:00Z",
  "last_sync_at": "2026-10-03",
  "companies_count": "29000000",
  "establishments_count": "41000000",
  "...": "..."
}

Réponse abrégée et valeurs fictives : la réponse contient aussi d'autres informations de chargement.

Abridged response with fictional values: the response also contains other import information.

Ingekort antwoord met fictieve waarden: het antwoord bevat ook andere laadinformatie.

Gekürzte Antwort mit fiktiven Werten: Die Antwort enthält auch weitere Ladeinformationen.

Mention de source : Insee (Sirene).

Source attribution: Insee (Sirene).

Bronvermelding: Insee (Sirene).

Quellenangabe: Insee (Sirene).