Errors & Rate Limits

HTTP Error Codes

Status	Meaning
`400`	Bad request — check your request body
`401`	Missing or invalid API key
`403`	API key lacks the required scope
`404`	Resource not found
`429`	Rate limit exceeded
`500`	Server error — contact support


{
  "success": false,
  "error": "Missing required field: league",
  "code": 400
}

When the limit is exceeded, the API returns 429 Too Many Requests. Check the Retry-After header to know when to retry:


HTTP/1.1 429 Too Many Requests
Retry-After: 30


{
  "success": false,
  "error": "Invalid or missing API key"
}

Ensure your Authorization header is formatted correctly:


Authorization: Bearer sk_live_abc123...


{
  "success": false,
  "error": "Insufficient scope: requires read:leagues"
}

Your API key doesn’t have the required scope. Regenerate it with the correct scopes from Settings → API Keys.


{
  "success": false,
  "error": "League not found"
}

Verify the resource ID is correct and belongs to your organization.

If you encounter a 500 error, contact support at hello@staty.io with the request details and timestamp.