`GET /v1/persons/{per_id}/game-log` — the person's chronological game log
(Workflow-1 task A4): per-game stat lines assembled over appearances + phase
tables, each tied to its game. Store-only; no *_game_logs table.
(Workflow-1 task A4): per-game stat lines assembled over appearances + phase
tables, each tied to its game. Store-only; no *_game_logs table.
Authorization
api_key In: header
Path Parameters
Minted person id (per_…)
Query Parameters
Competition slug (e.g. mlb) or minted comp_… id.
int32date-timedate-timeRestrict the game log to appearances carrying a specific phase block
(role=pitcher) — the agnostic replacement for the old
pitching-games endpoint. Omitted ⇒ every phase (today's behavior,
unchanged).
"pitcher"Alias for role: phase=pitching is equivalent to role=pitcher.
Contest-stage filter (issue #164). Omitted defaults to regular-season
(plus unknown-stage) appearances only — the same window the season
fold uses. stage=all removes the filter entirely (every stage,
including preseason/exhibition/allstar); an explicit stage
(preseason/regular/postseason/exhibition/allstar) narrows to
exactly that value. An unrecognized value is a 400.
Response Body
application/json
application/json
curl -X GET "https://example.com/v1/persons/string/game-log"{
"data": {
"items": [
{
"event": {
"id": "evt_0a1b2c3d4e5f6g7h8i9j0k1l2m",
"kind": "tournament",
"lineage": "wimbledon",
"name": "string",
"span": {
"end": "2019-08-24T14:15:22Z",
"start": "2019-08-24T14:15:22Z"
}
},
"game": "cst_0a1b2c3d4e5f6g7h8i9j0k1l2m",
"line": {
"appearance": "apr_0a1b2c3d4e5f6g7h8i9j0k1l2m",
"baseball": {
"batting_entry": 0,
"batting_slot": 0,
"position": "SF"
},
"person": "per_0a1b2c3d4e5f6g7h8i9j0k1l2m",
"phases": [
{
"measures": {},
"phase": "string"
}
],
"team": "team_0a1b2c3d4e5f6g7h8i9j0k1l2m"
}
}
],
"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
}
}