Documentation API

API NexeData

Intégrez la fiabilisation et l'enrichissement de vos données tiers directement dans vos applications via notre API REST.

Base URL: https://www.nexedata.fr/api Format: application/json Auth: Bearer token

Authentification

Chaque requête doit inclure votre token API dans le champ token du corps de la requête. Les tokens sont gérés depuis votre espace client.

Exemple de token
nxd_live_sk_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6
⚠ Crédits : Chaque appel consomme 1 crédit API. Consultez votre solde depuis le tableau de bord API.

Endpoints

POST /v1/getInfosFor

Récupère les informations légales et de contact d'un établissement à partir de son numéro SIRET. Les données sont issues de l'INSEE et enrichies via l'INPI.

Paramètres (body JSON)

Nom Type Requis Description
siret string Oui Numéro SIRET à 14 chiffres
token string Oui Token API NexeData
include_geo boolean Non Inclure les coordonnées GPS (défaut: true)

Requête

{
  "siret": "35285010800371",
  "token": "nxd_live_sk_a1b2c3...",
  "include_geo": true
}

Réponse 200

{
  "siret": "35285010800371",
  "siren": "352850108",
  "denomination": "LA POSTE",
  "enseigne": null,
  "forme_juridique": "SA à conseil d'administration",
  "etat_administratif": "A",
  "date_creation": "1991-01-01",
  "adresse": {
    "numero_voie": "9",
    "type_voie": "RUE",
    "libelle_voie": "DU COLONEL PIERRE AVIA",
    "code_postal": "75015",
    "commune": "PARIS 15",
    "departement": "75",
    "region": "Île-de-France"
  },
  "geo": {
    "latitude": 48.8318,
    "longitude": 2.2941
  },
  "activite": {
    "code_ape": "5310Z",
    "libelle_ape": "Activités de poste nationale"
  },
  "tva_intracommunautaire": "FR76352850108",
  "tranche_effectif": "5000 à 9999 salariés",
  "credits_consommes": 1,
  "credits_restants": 499
}

Codes d'erreur

400 Paramètre manquant ou SIRET invalide (longueur ≠ 14)
401 Token API invalide ou révoqué
404 Établissement introuvable dans la base INSEE
POST /v1/insee/compare

Compare un lot de données tiers avec la base INSEE officielle. Retourne un score qualité, les champs corrects/incorrects et les suggestions de correction pour chaque ligne.

Paramètres (body JSON)

Nom Type Requis Description
token string Oui Token API NexeData
rows array Oui Tableau de tiers à comparer (max 500 par appel)
rows[].siret string Oui SIRET à 14 chiffres
rows[].denomination string Non Raison sociale à vérifier
rows[].adresse string Non Adresse à vérifier
rows[].id string|int Non Identifiant interne, retourné tel quel dans la réponse

Requête

{
  "token": "nxd_live_sk_a1b2c3...",
  "rows": [
    {
      "id": "CLIENT-001",
      "siret": "35285010800371",
      "denomination": "LA POSTE SA",
      "adresse": "9 RUE DU COL. AVIA 75015 PARIS"
    },
    {
      "id": "CLIENT-002",
      "siret": "77568147900051",
      "denomination": "ORANGE",
      "adresse": "78 RUE OLIVIER DE SERRES 75015"
    }
  ]
}

Réponse 200

{
  "processed": 2,
  "credits_consumed": 2,
  "credits_remaining": 497,
  "duration_ms": 312,
  "results": [
    {
      "id": "CLIENT-001",
      "siret": "35285010800371",
      "status": "match",
      "score": 94,
      "fields": {
        "denomination": {
          "submitted": "LA POSTE SA",
          "official": "LA POSTE",
          "match": false,
          "suggestion": "LA POSTE"
        },
        "adresse": {
          "submitted": "9 RUE DU COL. AVIA 75015 PARIS",
          "official": "9 RUE DU COLONEL PIERRE AVIA 75015 PARIS 15",
          "match": false,
          "suggestion": "9 RUE DU COLONEL PIERRE AVIA 75015 PARIS 15"
        }
      },
      "etat_administratif": "A",
      "actif": true
    },
    {
      "id": "CLIENT-002",
      "siret": "77568147900051",
      "status": "match",
      "score": 100,
      "fields": {
        "denomination": {
          "submitted": "ORANGE",
          "official": "ORANGE",
          "match": true
        },
        "adresse": {
          "submitted": "78 RUE OLIVIER DE SERRES 75015",
          "official": "78 RUE OLIVIER DE SERRES 75015 PARIS 15",
          "match": false,
          "suggestion": "78 RUE OLIVIER DE SERRES 75015 PARIS 15"
        }
      },
      "etat_administratif": "A",
      "actif": true
    }
  ]
}

Valeurs de status

match

SIRET trouvé, établissement actif

closed

SIRET trouvé, établissement fermé

not_found

SIRET introuvable dans la base INSEE

Codes d'erreur

401 Token API invalide
402 Crédits insuffisants — rechargez votre solde
422 Données invalides (SIRET manquant, tableau vide…)
503 Stock INSEE temporairement indisponible

Limites & bonnes pratiques

500
lignes max par appel /compare
60 req/min
rate limit par token
1 crédit
consommé par ligne traitée

Exemples d'intégration

cURL 
curl -X POST https://www.nexedata.fr/api/v1/getInfosFor \
  -H "Content-Type: application/json" \
  -d '{
    "siret": "35285010800371",
    "token": "nxd_live_sk_a1b2c3d4e5f6g7h8i9j0"
  }'
PHP (Guzzle) 
use GuzzleHttp\Client;

$client = new Client(['base_uri' => 'https://www.nexedata.fr/api/']);

$response = $client->post('v1/getInfosFor', [
    'json' => [
        'siret' => '35285010800371',
        'token' => 'nxd_live_sk_a1b2c3d4e5f6g7h8i9j0',
    ]
]);

$data = json_decode($response->getBody(), true);
JavaScript (fetch) 
const response = await fetch('https://www.nexedata.fr/api/v1/getInfosFor', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    siret: '35285010800371',
    token: 'nxd_live_sk_a1b2c3d4e5f6g7h8i9j0',
  }),
});

const data = await response.json();

Besoin d'aide ?

Notre équipe technique est disponible pour vous accompagner dans l'intégration.

Contacter le support