Documentation de l'API

Une API REST unique pour valider vos données. Créez un compte (100 crédits offerts), générez une clé dans votre espace, puis appelez l'endpoint ci-dessous.

Authentification

Toutes les requêtes nécessitent votre clé API dans l'en-tête HTTP :

Authorization: Bearer dck_live_votre_cle

Endpoint

POST https://data-checker.fr/api/v1/validate

Corps de la requête (JSON) :

{
  "type": "email | phone | siret | iban",
  "value": "la valeur à vérifier",
  "country": "FR"   // optionnel, pour le téléphone (par défaut FR)
}

Chaque appel réussi consomme 1 crédit. Réponse 402 si le solde est épuisé.

Exemple (JavaScript)

const res = await fetch("https://data-checker.fr/api/v1/validate", {
  method: "POST",
  headers: {
    "Authorization": "Bearer dck_live_votre_cle",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ type: "email", value: "contact@exemple.fr" }),
});
const data = await res.json();
console.log(data.valid); // true | false

Réponses par type

{
  "type": "email",
  "input": "contact@exemple.fr",
  "valid": true,
  "syntaxValid": true,
  "domain": "exemple.fr",
  "mxFound": true,
  "disposable": false,
  "roleBased": true,
  "reason": null,
  "credits_remaining": 99
}

{
  "type": "phone",
  "input": "06 12 34 56 78",
  "valid": true,
  "e164": "+33612345678",
  "national": "06 12 34 56 78",
  "international": "+33 6 12 34 56 78",
  "country": "FR",
  "type_line": "mobile",
  "credits_remaining": 98
}

{
  "type": "siret",
  "input": "55210055400021",
  "valid": true,
  "kind": "SIRET",
  "siren": "552100554",
  "nic": "00021",
  "formatted": "552 100 554 00021",
  "laPoste": false,
  "vatNumber": "FR96552100554",
  "vatKey": "96",
  "reason": null,
  "credits_remaining": 97
}

{
  "type": "iban",
  "input": "FR1420041010050500013M02606",
  "valid": true,
  "country": "FR",
  "countryName": "France",
  "sepa": true,
  "formatOk": true,
  "lengthOk": true,
  "formatted": "FR14 2004 1010 0505 0001 3M02 606",
  "bankCode": "20041",
  "bank": "La Banque Postale",
  "bic": "PSSTFRPP",
  "bban": { "banque": "20041", "guichet": "01005", "compte": "0500013M026" },
  "ribKeyValid": true,
  "credits_remaining": 96
}

Sur le type siret, l'API contrôle la clé de Luhn (et la règle dérogatoire des SIRET La Poste en 356000000), renvoie le découpage siren + nic et dérive le n° de vatNumber (TVA intracommunautaire). Ces champs sont calculés à partir du numéro (format-only) : l'API ne vérifie pas l'existence de l'entreprise auprès de l'INSEE. Pour voir le calcul de Luhn déroulé chiffre par chiffre, utilisez le décodeur SIRET — il tourne dans le navigateur, sans clé ni crédit.

Sur le type iban, la réponse ajoute le pays, l'appartenance à la zone sepa, l'IBAN formatted et, pour un IBAN français, le découpage du bban (banque / guichet / compte), le contrôle de la clé RIB nationale (ribKeyValid) et le nom de banque + bic indicatif quand le code établissement est reconnu.

Codes d'erreur