GET /cricket/matches/{id}
Get cricket match by ID
Returns a single cricket match: innings totals, toss, result
In preview, not in plans yet Pay per call without a key: $0.005 in USDC
Parameters
idinteger · path required
Match ID
Response
JSON with success, the result in data, and where the endpoint pages its results meta.
dataobject
attributionstring
Matches from Cricsheet's history (before the provider's feeds): the
notice its licence (ODC-BY) asks for.
away_teamobject
idinteger
inningsarray of object
namestring
scorestring
end_datestring
formatstring
Test, First-class, ODI, T20...
home_teamobject
idinteger
inningsarray of object
namestring
scorestring
idinteger
league_idinteger
league_namestring
match_idinteger
match_numstring
resultstring
seasonstring
sportstring
start_datestring
start_timestring
statusstring
tossstring
toss_winner_idinteger
venuestring
winner_idinteger
errorobject
codestring
messagestring
metaobject
attributionstring
Attribution a data source's licence asks for (Cricsheet's history).
limitinteger
offsetinteger
totalinteger
successboolean
Errors
Status Code When
400 INVALID_PARAMA parameter is missing or wrong, and the message names it. Fix the request; do not retry it.
401 UNAUTHORIZEDThe key is missing, mistyped or was rotated.
402 x402 offersNo key and no valid payment: the body lists what to pay. Only a 200 answer is charged.
404 NOT_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? Yes No
curl JavaScript Python PHP
Copy
curl "https://api.sportstatsapi.com/api/v1/cricket/matches/1" \
-H "Authorization: Bearer $SPORTSTATS_KEY"
const res = await fetch(
"https://api.sportstatsapi.com/api/v1/cricket/matches/1" ,
{ headers: { Authorization: `Bearer ${process.env.SPORTSTATS_KEY}` } }
);
const { data } = await res.json();
import os, requests
res = requests.get(
"https://api.sportstatsapi.com/api/v1/cricket/matches/1" ,
headers={"Authorization" : f"Bearer {os.environ['SPORTSTATS_KEY']}" },
)
data = res.json()["data" ]
$ch = curl_init ("https://api.sportstatsapi.com/api/v1/cricket/matches/1" );
curl_setopt ($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer " . getenv("SPORTSTATS_KEY" )]);
curl_setopt ($ch, CURLOPT_RETURNTRANSFER, true );
$data = json_decode (curl_exec ($ch), true )["data" ];
200 OKExample response
{
"data" : {
"attribution" : "string" ,
"away_team" : {
"id" : 1 ,
"innings" : [
{
"overs" : "string" ,
"runs" : 0 ,
"wickets" : 0
}
],
"name" : "string" ,
"score" : "string"
},
"end_date" : "2026-10-14T18:00:00Z" ,
"format" : "string" ,
"home_team" : {
"id" : 1 ,
"innings" : [
{
"overs" : "string" ,
"runs" : 0 ,
"wickets" : 0
}
],
"name" : "string" ,
"score" : "string"
},
"id" : 1 ,
"league_id" : 1 ,
"league_name" : "string" ,
"match_id" : 1 ,
"match_num" : "string" ,
"result" : "string" ,
"season" : "string" ,
"sport" : "string" ,
"start_date" : "2026-10-14T18:00:00Z" ,
"start_time" : "2026-10-14T18:00:00Z" ,
"status" : "string" ,
"toss" : "string" ,
"toss_winner_id" : 1 ,
"venue" : "string" ,
"winner_id" : 1
},
"meta" : {
"attribution" : "string" ,
"limit" : 0 ,
"offset" : 0 ,
"total" : 0
},
"success" : false
}