400 · invalid-request

Quand cela arrive

Un paramètre de la requête n'est pas valide, ou l'endpoint ne le connaît pas : un limit hors de 1–100, un curseur qui n'est pas un identifiant, un curseur (starting_after, after) qui n'appartient pas à cette écurie, un filtre au mauvais format, un paramètre mal écrit (accountingmonth au lieu de accounting_month). Un paramètre inconnu n'est jamais ignoré : un filtre mal écrit renverrait la liste entière.

Champs supplémentaires

• invalid_param: Le nom du paramètre qui n'est pas valide, ou que l'endpoint ne connaît pas.

Que faire

Corrigez le paramètre indiqué dans invalid_param : les filtres de chaque liste sont dans Conventions. Pour un curseur after qui n'appartient pas à cette écurie, recommencez sans lui.

La réponse

{
  "type": "https://stable-pro.com/docs/api/problems/invalid-request",
  "title": "The request is not valid",
  "status": 400,
  "detail": "…"
}

Dans title, l'API écrit toujours le texte anglais : « The request is not valid ».

Décidez selon type, jamais selon detail : voir Erreurs.