Error types

Each error response links its type to one of these pages.

422Validation error validation-error

A query or path parameter is missing, has the wrong type, or is outside its allowed range.

404Match not found match_not_found

No match has this id in any id form (live, upcoming or archived).

404Player not found player_not_found

No player has this id.

404Tournament not found tournament_not_found

No tournament edition has this id.

503Data store unavailable database_unavailable

The data store did not answer in time. Nothing is wrong with the request.

400Bad request http-400

The request could not be understood as sent.

401Unauthorized http-401

No API key, or a key that is not valid.

403Forbidden http-403

The key is valid but the plan does not include this: another sport on a Starter key, data older than the plan's history window, or WebSockets without the add-on.

404Not found http-404

No resource at this path or with this id.

405Method not allowed http-405

The API is read-only: every endpoint is GET.

409Conflict http-409

The request conflicts with the current state of the resource.

422Unprocessable http-422

Parameters are present but not valid together, for example an end date before a start date.

429Too many requests http-429

Your plan's per-minute rate or monthly quota is used up.

500Internal error http-500

The API failed to answer a valid request.

502Bad gateway http-502

An internal hop between API services failed.

503Service unavailable http-503

The data service is briefly unavailable (code TENNIS_UPSTREAM_UNAVAILABLE through the public gateway).

504Gateway timeout http-504

An internal hop timed out.