Errors

A non-2xx body is:

{
  "error": "not_found",
  "message": "…",
  "request_id": "…",
  "details": null,
  "retry_after_seconds": null
}

error is stable. message is not. The same id is in the X-Request-Id header.

Code	Status
invalid_request	400
unauthenticated	401
token_invalid	401
forbidden_role	403
org_not_member	403
scope_insufficient	403
not_found	404
conflict	409
idempotency_key_reused	409
insufficient_funds	409
verification_required	409
currency_locked	409
connection_in_use	409
quote_expired	410
channel_ceiling_exceeded	409
unprocessable	422
rate_limited	429
dependency_unavailable	503
dependency_timeout	504
internal_error	500

An unknown path on /v1 is also 404 not_found. That means the route does not exist. It does not mean a row is missing.