tennisdatabaseAPI

Tennis API documentation

Ctrl K
DocsStart here

Errors

Every failure has the same shape and a code you can switch on. The docs link comes here.

{
  "error": {
    "code": "upgrade_required",
    "message": "This endpoint is on the Live plan and above.",
    "plan": "Live",
    "upgrade": "https://tennisdatabaseapi.com/pricing",
    "docs": "https://tennisdatabaseapi.com/documentation/errors"
  }
}

1Codes

HTTPCodeMeaning
400bad_requestA parameter is missing or out of range, or the key was sent in the address.
401unauthorizedNo key, or a key that is unknown or revoked.
403upgrade_requiredThe plan does not include this endpoint or these dates; the error names the plan that does.
404not_foundNo such endpoint, or no such id.
422unknown_parameterA parameter this endpoint does not take; the message lists the ones it does.
429rate_limitedToo many calls this minute; wait for Retry-After.
429quota_exceededThe day's or month's allowance is used; the message says when it resets.
500server_errorSomething went wrong on our side; it has been logged.
503server_errorA part of the service is unavailable for a moment; try again shortly.