Skip to content
Get a key
API reference / Tennis
GET/tennis/matches

List tennis matches

Returns a paginated list of tennis matches with optional filtering

In the plans that cover this sportPay per call without a key: $0.002 in USDC

Parameters

  • limitinteger · query

    Maximum results (1-100)

    Default: 50
  • offsetinteger · query

    Results to skip

    Default: 0
  • datestring · query

    Filter by date (YYYY-MM-DD)

  • date_fromstring · query

    Matches on or after this date (YYYY-MM-DD)

  • date_tostring · query

    Matches on or before this date (YYYY-MM-DD)

  • statusstring · query

    Filter by status (NS, Set 1, Set 2, Finished, Retired, Cancelled)

  • category_idinteger · query

    Filter by category ID

  • tourstring · query

    Filter by tour (atp, wta, challenger men, itf men, itf women, etc.)

  • disciplinestring · query

    Filter by discipline (singles, doubles)

  • stagestring · query

    Filter by stage (main, qualification)

  • surfacestring · query

    Filter by surface (clay, hard, grass, hard (indoor), etc.)

Response

JSON with success, the result in data, and where the endpoint pages its results meta.

  • dataarray of object
  • category_idinteger
  • category_namestring
  • competitor1object
  • game_scorestring
  • idinteger
  • member_idsarray of integer
  • namestring
  • servingboolean
  • sets_woninteger
  • winnerboolean
  • competitor2object
  • game_scorestring
  • idinteger
  • member_idsarray of integer
  • namestring
  • servingboolean
  • sets_woninteger
  • winnerboolean
  • disciplinestring
  • idinteger
  • match_idinteger
  • set_scoresobject
  • s1object
  • s2object
  • s3object
  • s4object
  • s5object
  • sportstring
  • stagestring
  • start_datestring
  • start_timestring
  • statusstring
  • surfacestring
  • tiebreakboolean
  • tourstring
  • errorobject
  • codestring
  • messagestring
  • metaobject
  • attributionstring

    Attribution a data source's licence asks for (Cricsheet's history).

  • limitinteger
  • offsetinteger
  • totalinteger
  • successboolean

Errors

StatusCodeWhen
401UNAUTHORIZEDThe key is missing, mistyped or was rotated.
402x402 offersNo key and no valid payment: the body lists what to pay. Only a 200 answer is charged.
403FORBIDDENThe sport or feature is not in your plan (FEATURE_NOT_IN_PLAN for Insights and other plan features).
429RATE_LIMIT_EXCEEDEDToo many requests (QUOTA_EXCEEDED for the daily limit). Wait for Retry-After.
500INTERNAL_ERROROur side. Try again after a few seconds and check the status page.

All errors have the shape described in Errors and limits.

Generated from the OpenAPI file, version 1.0. See it as JSON

Was this page helpful?