Skip to main content
Errors share one body:
  • code is stable: branch on it.
  • message is for humans and may change.
  • details is present on some errors and described below.
New codes can be added. Treat an unknown code like any other error of its HTTP status.

Request errors

Authentication and access

Order rejections

These are the checks made before anything is sent to a bookmaker. When one fails, nothing is recorded: no order, no bet. Once the checks pass, the order is recorded. A bookmaker that then declines does not make the request fail. The order comes back with 201, and each declined bet carries its declineReason. When every bet is declined, the order’s status is REJECTED.

Service errors

Every response carries an x-request-id header. Quote it when you report an error.