statshawk
REST APICompetitions

`GET /v1/competitions/{comp}/editions/{year}/contests?date=`.

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

Authorization

api_key
X-API-Key<token>

In: header

Path Parameters

comp*string

Competition slug (nba, mlb, pga, …)

year*string

Season year (e.g. 2026)

Query Parameters

date?|
Formatdate

Response Body

application/json

application/json

curl -X GET "https://example.com/v1/competitions/string/editions/string/contests"
{
  "data": {
    "items": [
      {
        "competition": "comp_0a1b2c3d4e5f6g7h8i9j0k1l2m",
        "edition": "edt_0a1b2c3d4e5f6g7h8i9j0k1l2m",
        "entrants": [
          {
            "entrant": "ent_0a1b2c3d4e5f6g7h8i9j0k1l2m",
            "result": {
              "aggregate": {
                "score": 0
              },
              "position": 0,
              "status": "final",
              "tiebreak": {
                "score": 0
              },
              "value": {
                "score": 0
              }
            },
            "seed": 0,
            "start_slot": 0,
            "subject": {
              "kind": "team",
              "name": "string",
              "team": "team_0a1b2c3d4e5f6g7h8i9j0k1l2m"
            }
          }
        ],
        "event": {
          "id": "evt_0a1b2c3d4e5f6g7h8i9j0k1l2m",
          "kind": "tournament",
          "lineage": "wimbledon",
          "name": "string",
          "span": {
            "end": "2019-08-24T14:15:22Z",
            "start": "2019-08-24T14:15:22Z"
          }
        },
        "id": "cst_0a1b2c3d4e5f6g7h8i9j0k1l2m",
        "kind": "match",
        "location": {
          "city": "string",
          "country": "string",
          "neutral_site": true,
          "venue_name": "string"
        },
        "relations": [
          {
            "from": "cst_0a1b2c3d4e5f6g7h8i9j0k1l2m",
            "kind": "winner_advances_to",
            "round": {
              "numbered": 0
            },
            "slot": 0,
            "to": "cst_0a1b2c3d4e5f6g7h8i9j0k1l2m"
          }
        ],
        "starts_at": "2019-08-24T14:15:22Z",
        "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
  }
}

`GET /v1/competitions/{comp}/capabilities` — the per-phase measure inventory GET

for the competition's sport (spec §5), re-homed off the slug. Resolves the competition (store-only), then derives the surface from the phase registry.

`GET /v1/competitions/{comp}/editions/{year}/games?date=`. GET

Next Page