Errors

The Elite Prospects API uses standard HTTP status codes.

Status codes

Status	Meaning	Common causes
`200 OK`	Success.	—
`400 Bad Request`	The request was malformed.	Unknown field requested via `fields`, unsupported filter, invalid sort key, out-of-range numeric parameter.
`401 Unauthorized`	Missing or invalid `apiKey`.	Key not provided, key revoked, typo.
`403 Forbidden`	The resource isn’t included in your subscription.	The endpoint, region, season, or category isn’t part of your plan — see Coverage.
`404 Not Found`	The route or resource does not exist.	Wrong path, unknown id or slug.
`429 Too Many Requests`	Rate limit exceeded.	Sending requests faster than your plan allows.
`5xx Server Error`	Server-side problem.	Transient — retry with backoff.

Handling errors

const response = await fetch(url);
if (!response.ok) {
  const body = await response.json().catch(() => ({}));
  throw new Error(`${response.status} ${response.statusText}: ${body.message ?? "unknown"}`);
}
const { data, _meta } = await response.json();

For 429 and 5xx, retry with exponential backoff. For 4xx other than 429, the request needs to change — retrying without modification won’t succeed. If a 403 is unexpected for data you should have access to, contact [email protected].

Getting started

Using the API

Status codes

Handling errors

​Status codes

​Handling errors

Status codes

Handling errors