Erreurs

API BCE utilise les codes de statut HTTP conventionnels. 2xx = succès, 4xx = problème dans votre requête, 5xx = problème de notre côté.

Codes de statut#

Type	Description
`400`	Requête mal formée ou paramètre requis manquant.
`401`	Identifiants API manquants ou invalides.
`402`	Abonnement inactif ou quota mensuel épuisé.
`403`	Votre clé n’est pas autorisée à accéder à cette ressource.
`404`	L’entité demandée n’existe pas.
`412`	Une précondition requise (en-têtes, etc.) n’est pas remplie.
`429`	Limite horaire ou quota mensuel dépassé.
`500`	Erreur de notre côté. Réessayez plus tard.

Les erreurs utilisent la même enveloppe ; le message est dans error. Les erreurs de quota et de débit ajoutent plan, limit et resetAt.

{
  "success": false,
  "error": "Monthly quota exceeded",
  "plan": "free",
  "limit": 1000,
  "resetAt": "2026-07-01T00:00:00.000Z"
}

ℹ️

Réessayez les réponses 429 et 5xx avec un backoff exponentiel. Ne réessayez pas les 4xx autres que 429.