forbidden

Statut HTTP : 403 · Rejouable : non.

Cause

Votre identité est reconnue mais l'opération est refusée. C'est le code par défaut de toute réponse 403 qui ne porte pas de code plus précis.

Le cas de loin le plus fréquent a son propre code : quand le refus vient d'un scope manquant, l'API renvoie insufficient_scope avec la liste exacte des scopes attendus. Recevoir forbidden signifie donc que la cause est ailleurs — typiquement une ressource qui appartient à une autre organisation, ou une opération indisponible pour votre intégration.

Réponse

HTTP/1.1 403 Forbidden
Content-Type: application/problem+json

{
  "type": "https://docs.pesia.fr/partner/errors/forbidden",
  "title": "Forbidden",
  "status": 403,
  "detail": "Forbidden",
  "code": "forbidden",
  "instance": "/partner/v1/agencies/8f2c1a44-0d1e-4f37-9b21-5c3a77e0d912",
  "timestamp": "2026-08-14T09:12:44.318Z"
}

Extensions

Aucune — seuls les champs standard ci-dessus.

Que faire

• Vérifier que l'identifiant visé provient bien d'une réponse de l'API pour votre organisation.
• Ne pas rejouer en boucle : le refus est stable, un rejeu produira le même résultat.
• Si l'opération devrait vous être ouverte, contactez votre interlocuteur Pesia (partenaires@pesia.fr) en citant le correlationId de la réponse.

Voir aussi : Scopes · Authentification · Tous les codes d'erreur