Errors
Below are common errors returned by the API. These will be contained in the error block.
| AUTHORIZE_FAILED | The key is incorrect, invalid, or expired. Please refer to the account page (requires login) to check the API key. |
| TOO_MANY_REQUESTS | The API key has exceeded its rate limit. Please refer to information on rate limits. |
| NO_ENDPOINT | A valid endpoint has not been specified. Please refer to the list of endpoints for guidance. |
| PARAMETER_MISSING | A valid sport or level path parameter has not been specified. Please refer to the list of acceptable values. |
| UNAUTHORIZED | The API key has exhausted its allocation of free tokens, and the account must be upgraded in order for the key to be restored. |
| OUT_OF_RANGE | This 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). |
| UNDER_MAINTENANCE | The API is undergoing maintenance or temporary downtime. In the case of scheduled maintenance, the meta block may include details on when the service will be active again. |
| BLOCKED | The API key has been temporarily suspended or permanently revoked due to multiple IP access, improperly written code that affects other customers' use of the API in any way, or construction of an identical app or website that utilizes a high percentage of National Statistical's data. Please review our three-strike policies on API abuse. |
Below is a sample PHP-formatted error block for an account that has exhausted its allocation of free tokens.
[error] => SimpleXMLElement Object
(
[message] => UNAUTHORIZED
[detail] => Your account does not have API access. Please refer to http://natstat.com/subscribe for subscription options.
)