statshawk
REST APICompetitions

GET /v1/competitions/{comp}/editions/{year}/games?date=&stage=. date is the competition-local US-Eastern slate date — see [EditionGamesQuery].

cost 2 unitsany plan
GET
/v1/competitions/{comp}/editions/{year}/games

Authorization

X-API-Key<token>

Raw API key (sk_live_… or sk_test_…). Preferred for REST clients. Keys are read-only; the environment prefix is the only key role. See https://statshawk.ai/docs/getting-started/permissions

In: header

Path Parameters

comp*string

Competition slug (nba, mlb, epl, …)

year*string

Season start year (e.g. 2026) — cross-year leagues (NBA/NHL/NCAA) use the year the season STARTS in (2025 = the 2025-26 season)

Query Parameters

date?|
Formatdate
stage?|

Exact contest stage. Omitted preserves the schedule listing's existing all-stage behavior.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/competitions/string/editions/string/games"
{
  "data": {
    "items": [
      {
        "away_team": "team_0a1b2c3d4e5f6g7h8i9j0k1l2m",
        "away_team_name": "string",
        "competition": "comp_0a1b2c3d4e5f6g7h8i9j0k1l2m",
        "edition": "edt_0a1b2c3d4e5f6g7h8i9j0k1l2m",
        "event": null,
        "home_team": "team_0a1b2c3d4e5f6g7h8i9j0k1l2m",
        "home_team_name": "string",
        "id": "cst_0a1b2c3d4e5f6g7h8i9j0k1l2m",
        "kickoff": "2019-08-24T14:15:22Z",
        "location": null,
        "score": null,
        "stage": null,
        "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
  }
}
{
  "error": {
    "code": "string",
    "message": "string",
    "property1": null,
    "property2": null
  }
}
{
  "error": {
    "code": "string",
    "message": "string",
    "property1": null,
    "property2": null
  }
}
{
  "error": {
    "code": "string",
    "message": "string",
    "property1": null,
    "property2": null
  }
}
{
  "error": {
    "code": "string",
    "message": "string",
    "property1": null,
    "property2": null
  }
}
{
  "error": {
    "code": "string",
    "message": "string",
    "property1": null,
    "property2": null
  }
}
{
  "error": {
    "code": "string",
    "message": "string",
    "property1": null,
    "property2": null
  }
}