statshawk
REST APIContests

GET /v1/contests/{contest_id}/matchup — the pregame matchup card (probable pitchers + lineups) for one contest.

cost 1 unitany plan
GET
/v1/contests/{contest_id}/matchup

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

contest_id*string

Minted contest id (cst_…)

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/contests/string/matchup"
{
  "data": {
    "away_lineup": [
      {
        "bat_side": null,
        "batting_order": 0,
        "confirmed": true,
        "name": "string",
        "person_id": "per_0a1b2c3d4e5f6g7h8i9j0k1l2m",
        "position": null
      }
    ],
    "away_probable_pitcher": null,
    "away_team": null,
    "contest": "cst_0a1b2c3d4e5f6g7h8i9j0k1l2m",
    "game_time": "2019-08-24T14:15:22Z",
    "home_lineup": [
      {
        "bat_side": null,
        "batting_order": 0,
        "confirmed": true,
        "name": "string",
        "person_id": "per_0a1b2c3d4e5f6g7h8i9j0k1l2m",
        "position": null
      }
    ],
    "home_probable_pitcher": null,
    "home_team": null,
    "lineups_available": true,
    "status": "string"
  },
  "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
  }
}