Skip to main content
The Elite Prospects API uses standard HTTP status codes.

​
Status codes

StatusMeaningCommon causes
200 OKSuccess.—
400 Bad RequestThe request was malformed.Unknown field requested via fields, unsupported filter, invalid sort key, out-of-range numeric parameter.
401 UnauthorizedMissing or invalid apiKey.Key not provided, key revoked, typo.
403 ForbiddenThe resource isn’t included in your subscription.The endpoint, region, season, or category isn’t part of your plan — see Coverage.
404 Not FoundThe route or resource does not exist.Wrong path, unknown id or slug.
429 Too Many RequestsRate limit exceeded.Sending requests faster than your plan allows.
5xx Server ErrorServer-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].