API v4 Documentation

Endpoints Code Lookup

Errors

Below are common errors returned by the API. These will be contained in the error node.

UNDER_MAINTENANCEThe API is undergoing maintenance or temporary downtime. In the case of scheduled maintenance, the meta block will include details on when the API will be active again.
AUTHORIZE_FAILEDThe key is incorrect, invalid, or expired. Please refer to your account page (requires login) to check the API key.
NO_ENDPOINTA valid endpoint has not been specified. Please refer to the list of endpoints for guidance.
PARAMETER_MISSINGA valid sport or level path parameter has not been specified. Please refer to the list of acceptable values.
CONCURRENCYThe API key is attempting more than four queries per second, which is not permitted. This can be circumvented by subscribing to API+, which removes IP and concurrency restrictions.
OUT_OF_RANGEThis message occurs when the API key is not valid for the sport requested (e.g. the API key is owned by a user with a valid NBA subscription, and the MBB endpoint is called).
OUT_OF_CALLSThe API key has exceeded its rate limit. Please refer to information on rate limits.
TOO_MANY_IPBLOCKSThe key has accessed the API from too many different IP blocks (X.X.-.-) within a 24-hour period. This can be circumvented by subscribing to API+, which removes IP and concurrency restrictions.
APIPLUS_ONLYYou've attempted to access a premium service or closed beta that is only available to API+ subscribers. This can be remedied by subscribing to API+.
BLOCKEDThe API key has been temporarily suspended or permanently revoked, and you have been sent an email detailing why.