API LegalOne : quotas et erreurs 401, 404, 429

Une clé gratuite de l'API LegalOne donne 60 requêtes par minute, 5 000 par jour et 100 000 par mois, dont 20 recherches par minute ; au-delà, l'API répond 429 et il faut attendre le délai indiqué par Retry-After.

Le tableau officiel est sur la page quotas de l'API LegalOne.

Quels sont les quotas de l'API LegalOne ?

Quand les compteurs repartent-ils à zéro ?

• La limite par minute porte sur les 60 dernières secondes.
• Le compteur du jour repart à minuit UTC, celui du mois le 1er.
• Une requête refusée n'est pas comptée.

Contourner les quotas avec plusieurs comptes, clés ou adresses IP est interdit. Pour plus de volume, voir demander un quota supérieur.

Comment suivre sa consommation ?

Votre espace développeur affiche la consommation du jour et du mois, clé par clé. Chaque réponse porte aussi les en-têtes X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset. Pour les voir :

curl -i -H "Authorization: Bearer lo_votre_cle" \
  https://api.legalone.fr/v1/entreprises/552032534

Que faire en cas d'erreur 401 ?

L'erreur 401 veut dire que la clé est absente, inconnue ou révoquée.

1. Vérifiez que la requête contient l'en-tête Authorization: Bearer lo_….
2. Vérifiez dans votre espace développeur que la clé est toujours active.
3. Si vous avez perdu la clé, créez-en une nouvelle : une clé ne peut pas être réaffichée.

Après 30 erreurs 401 en une minute depuis la même adresse IP, l'API répond 429.

Que veut dire une erreur 404 « non diffusable » ?

L'entreprise, l'établissement ou l'avis n'existe pas, ou ne peut pas être diffusé : diffusion restreinte par l'INSEE, opposition, avis retiré. L'API ne dit pas lequel, exprès.

• Ne réessayez pas : la réponse ne changera pas.
• Dans un formulaire, laissez votre client saisir les informations à la main.
• Si vous aviez enregistré cette donnée, retirez-la sous 7 jours : les conditions d'utilisation l'exigent.

Que faire en cas d'erreur 429 ?

Attendez le nombre de secondes indiqué dans l'en-tête Retry-After, puis réessayez. Si cela arrive souvent, demandez un quota supérieur.

Et les erreurs 400, 500 et 503 ?

• 400 : un paramètre a un mauvais format (un SIREN a 9 chiffres, un SIRET 14). Le champ detail de la réponse dit quoi corriger.
• 500 : erreur interne. Envoyez le requestId de la réponse à api@legalone.fr.
• 503 : service momentanément indisponible. Réessayez après le délai de Retry-After.

Toutes les erreurs suivent le même format (norme RFC 9457). Le détail de chaque route est sur la page API et serveur MCP.

Mis à jour le : 29/10/2026