API

Errors

Status codes and error codes the API returns.

When a request fails, data is null and error describes the problem.

{
  "data": null,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "API key is invalid or revoked."
  }
}
HTTPerror.codeWhen
400BAD_REQUESTA path id is not a UUID.
401UNAUTHORIZEDThe key is missing, unknown or revoked.
404NOT_FOUNDThe club, team, match or player is not in your club.
405BAD_REQUESTThe method is not allowed on this route. Only the insight URLs accept POST.
500INTERNAL_ERRORSomething failed on our side. Retry after a short wait.
503INTERNAL_ERRORInsight generation is not configured, or the generator could not be reached.

Anything outside your club returns 404, not 403, so a key cannot be used to discover other clubs' data.