REST APIContests
`GET /v1/contests/{contest_id}/matchup` — the pregame matchup card
(probable pitchers + lineups) for one contest.
cost 1 unitany plan
(probable pitchers + lineups) for one contest.
Authorization
api_key X-API-Key<token>
In: header
Path Parameters
contest_id*string
Minted contest id (cst_…)
Response Body
application/json
application/json
curl -X GET "https://example.com/v1/contests/string/matchup"{
"data": {
"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"
},
"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
}
}