statshawk
REST APICompetitions

`GET /v1/competitions/{comp}/editions/{year}/matchups?date=` — the

pregame matchup board for one calendar day of an edition's slate.

cost 3 unitsany plan
GET
/v1/competitions/{comp}/editions/{year}/matchups

pregame matchup board for one calendar day of an edition's slate.

Authorization

api_key
X-API-Key<token>

In: header

Path Parameters

comp*string

Competition slug (mlb, …)

year*string

Season year (e.g. 2026)

date*string
Formatdate

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/v1/competitions/string/editions/string/matchups"
{
  "data": {
    "items": [
      {
        "away_lineup": [
          {
            "bat_side": "string",
            "batting_order": 0,
            "confirmed": true,
            "name": "string",
            "person_id": "per_0a1b2c3d4e5f6g7h8i9j0k1l2m",
            "position": "SF"
          }
        ],
        "away_probable_pitcher": {
          "name": "string",
          "person_id": "per_0a1b2c3d4e5f6g7h8i9j0k1l2m",
          "throws": "string"
        },
        "away_team": {
          "name": "string",
          "team_id": "team_0a1b2c3d4e5f6g7h8i9j0k1l2m"
        },
        "contest": "cst_0a1b2c3d4e5f6g7h8i9j0k1l2m",
        "game_time": "2019-08-24T14:15:22Z",
        "home_lineup": [
          {
            "bat_side": "string",
            "batting_order": 0,
            "confirmed": true,
            "name": "string",
            "person_id": "per_0a1b2c3d4e5f6g7h8i9j0k1l2m",
            "position": "SF"
          }
        ],
        "home_probable_pitcher": {
          "name": "string",
          "person_id": "per_0a1b2c3d4e5f6g7h8i9j0k1l2m",
          "throws": "string"
        },
        "home_team": {
          "name": "string",
          "team_id": "team_0a1b2c3d4e5f6g7h8i9j0k1l2m"
        },
        "lineups_available": true,
        "status": "string"
      }
    ],
    "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
  }
}

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

Previous Page

`GET /v1/competitions/{comp}/editions/{year}/standings` — the app-materialized GET

`(edition, team)` records (Workflow-1 task A3), best-record-first. Store-only: the records are recomputed by the runner on ingest, never fetched here.