Démarrage rapide¶

1. Essayer sans clé¶

Les endpoints de vérification sont ouverts aux appels anonymes, limités à 20 requêtes par minute et par IP, pour que vous puissiez les évaluer avant de vous inscrire :

curl https://verify.orvel.dev/v1/vat/FR03552081317
curl https://verify.orvel.dev/v1/iban/DE89370400440532013000
curl "https://verify.orvel.dev/v1/phone/0612345678?region=FR"

2. Obtenir une clé¶

Prenez le plan Free sur la page Tarifs : 500 appels par mois, sans carte. Le paiement vous amène sur Votre clé API, qui affiche une clé de la forme ev.sub_1abc….. Utilisez-la en jeton bearer :

export EV_KEY=ev.sub_1abc.deadbeef

curl -H "Authorization: Bearer $EV_KEY" \
  https://verify.orvel.dev/v1/siren/552081317

Chaque réponse porte l'état du quota dans ses en-têtes :

X-Plan: free
X-Usage-Used: 1
X-Usage-Quota: 500
X-Usage-Remaining: 499

3. Lire le statut, pas le code HTTP¶

Une requête bien formée renvoie 200 même si l'identifiant se révèle faux. Le verdict est dans status :

curl -s -H "Authorization: Bearer $EV_KEY" \
  https://verify.orvel.dev/v1/vat/DE999999999 | jq '{status, reason}'

{ "status": "invalid", "reason": "the number is not registered for intra-EU trade" }

Quand un registre est hors service, vous obtenez upstream_unavailable, un en-tête Retry-After, et aucun décompte sur votre quota :

{ "status": "upstream_unavailable", "reason": "the member state register is unavailable", "retry_after_s": 60 }

À traiter comme « inconnu », jamais comme « invalide ».

4. Les mêmes outils depuis un agent¶

Pointez n'importe quel client MCP sur https://verify.orvel.dev/mcp avec la même clé :

{
  "mcpServers": {
    "eu-verify": {
      "url": "https://verify.orvel.dev/mcp",
      "headers": { "Authorization": "Bearer ev.sub_1abc.deadbeef" }
    }
  }
}

Détails et exemples par client : Serveur MCP.

5. Vérifier sa consommation¶

curl -H "Authorization: Bearer $EV_KEY" https://verify.orvel.dev/v1/usage

{ "plan": "free", "used": 12, "quota": 500, "remaining": 488, "period": "2026-09" }

Les quotas sont remis à zéro le 1er du mois (UTC). Changement de plan et factures : espace client.