> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.legalone.fr/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 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](https://legalone.fr/developers#quotas).

## Quels sont les quotas de l'API LegalOne ?

| Accès | Par minute | Par jour | Par mois | Recherche par minute |
|---|---|---|---|---|
| Clé gratuite | 60 | 5 000 | 100 000 | 20 |
| Quota supérieur (gratuit, sur demande) | 300 | 25 000 | 500 000 | 60 |
| Connecteur MCP sans clé (par adresse IP) | 60 | 1 000 | — | — |

## 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](https://help.legalone.fr/fr/article/quota-superieur-api-pwgur/).

## Comment suivre sa consommation ?

Votre [espace développeur](https://api.legalone.fr/compte) 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 :

```bash
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](https://help.legalone.fr/fr/article/cle-api-compte-developpeur-8205dv/) : 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](https://help.legalone.fr/fr/article/quota-superieur-api-pwgur/).

## 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](mailto: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](https://legalone.fr/developers#routes).