Getting startedErrors

Errors

When something goes wrong, the status code says what kind of problem it is and the body says what to do about it.

Status codes

StatusCodeWhat to do
200—Success.
400INVALID_PARAMA parameter is not valid; INVALID_ID, INVALID_DATE and INVALID_SPORT name which. The message says more.
401UNAUTHORIZEDThe key is missing, wrong or rotated. Check the header.
403FORBIDDENThe sport is not in your plan; FEATURE_NOT_IN_PLAN for Insights. Upgrade or change the request.
404NOT_FOUNDNo match, team or competition with that id.
429RATE_LIMIT_EXCEEDEDToo many requests; QUOTA_EXCEEDED for the daily limit. Wait for Retry-After.
500INTERNAL_ERROROur side. Retry later and check the status page.

Error body

Every error has the same shape, with a stable code for your program and a message for people, as in the example.