Errors - Playbook-API

Errors

The API uses standard HTTP status codes.

Status Codes

200 OK — request succeeded

400 Bad Request — missing/invalid parameters (ex: missing league)

401 Unauthorized — missing/invalid api_key

404 Not Found — endpoint not found

429 Too Many Requests — rate limit exceeded

500 Server Error — unexpected error

Error Response Format

Errors return JSON in this general shape:

{
  "error": "Unauthorized",
  "message": "Invalid or missing api_key"
}

Common Causes

401: api_key missing, misspelled param name, invalid key

400: league missing or not supported

429: too many requests in a short window