400 · invalid-request

When

A query parameter is not valid, or the endpoint does not know it: a limit outside 1–100, a cursor that is not an id, a cursor (starting_after, after) that does not belong to this stable, a filter with a wrong format, a parameter written wrongly (accountingmonth instead of accounting_month). An unknown parameter is never ignored: a misspelt filter would return the whole list.

Extra fields

• invalid_param: The name of the parameter that is not valid, or that the endpoint does not know.

What to do

Correct the parameter named in invalid_param: the filters of each list are in Conventions. For an after cursor that does not belong to this stable, start again without it.

The response

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

Decide on type, never on detail: see Errors.