Skip to content
API reference / Esports
GET/esports/matches/{id}

Get esports match by ID

One esports match

In preview, not in plans yetPay per call without a key: $0.005 in USDC

Parameters

  • idinteger · pathrequired

    Match ID

Response

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

  • dataobject
  • attributionstring

    Attribution is set on a Valorant match from Liquipedia, and on a walkover whose winner came from it.

  • away_teamobject
  • idinteger
  • namestring
  • scoreinteger
  • best_ofinteger
  • gamestring

    cs2, dota2, lol...

  • has_mapsboolean

    maps or games with player lines at /matches/{id}/maps

  • home_teamobject
  • idinteger
  • namestring
  • scoreinteger
  • idinteger
  • league_idinteger
  • league_namestring

    "CS2: ESL Pro League Playoffs"

  • match_idinteger
  • start_datestring
  • start_timestring
  • statusstring

    NS, Started, Pause, Finished, WO, Postponed, Canceled

  • winnerstring

    Winner: home or away, for a finished series (the higher score) and a walkover whose winner is known (WO is stored 0-0; winner_source liquipedia when Liquipedia gave it).

  • winner_sourcestring
  • errorobject
  • codestring
  • messagestring
  • metaobject
  • attributionstring

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

  • limitinteger
  • offsetinteger
  • totalinteger
  • successboolean

Errors

StatusCodeWhen
400INVALID_PARAMA parameter is missing or wrong, and the message names it. Fix the request; do not retry it.
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.
404NOT_FOUNDNo record with that id.

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?