REST APICompetitions
`GET /v1/competitions/{comp}/editions/{year}/games?date=`.
cost 2 unitsany plan
Authorization
api_key X-API-Key<token>
In: header
Path Parameters
comp*string
Competition slug (nba, mlb, epl, …)
year*string
Season year (e.g. 2026)
Query Parameters
date?|
Format
dateResponse Body
application/json
application/json
curl -X GET "https://example.com/v1/competitions/string/editions/string/games"{
"data": {
"items": [
{
"away_team": "team_0a1b2c3d4e5f6g7h8i9j0k1l2m",
"competition": "comp_0a1b2c3d4e5f6g7h8i9j0k1l2m",
"edition": "edt_0a1b2c3d4e5f6g7h8i9j0k1l2m",
"event": {
"id": "evt_0a1b2c3d4e5f6g7h8i9j0k1l2m",
"kind": "tournament",
"lineage": "wimbledon",
"name": "string",
"span": {
"end": "2019-08-24T14:15:22Z",
"start": "2019-08-24T14:15:22Z"
}
},
"home_team": "team_0a1b2c3d4e5f6g7h8i9j0k1l2m",
"id": "cst_0a1b2c3d4e5f6g7h8i9j0k1l2m",
"kickoff": "2019-08-24T14:15:22Z",
"location": {
"city": "string",
"country": "string",
"neutral_site": true,
"venue_name": "string"
},
"score": {
"away": 0,
"home": 0
},
"status": "scheduled"
}
],
"page": 0,
"per_page": 0,
"total": 0
},
"meta": {
"cache": "HIT",
"fetched_at": "2025-10-15T18:30:00Z",
"request_id": "266ea41d-adf5-480b-af50-15b940c2b846",
"source": "postgres",
"version": "v1"
}
}{
"error": {
"code": "string",
"message": "string",
"property1": null,
"property2": null
}
}