---
title: "Get Audit Games"
method: GET
path: "/api/audit/games"
tags: ["audit"]
---

# Get Audit Games

`GET /api/audit/games`

## Request

- Base URL: `https://api.fairline.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.fairline.io/api/audit/games`
- Auth: HTTP bearer

Fetch all game projections for a date range.

Returns full projection data (including JSONB blobs) for auditing model
performance against actual results. Use include_snapshots=true to get
historical projection data from every pipeline run, not just the latest.

## Query parameters

- `start_date` string, date, required: Start of date range (inclusive)
- `end_date` string, date, required: End of date range (inclusive)
- `sport` string, nullable: Filter by sport (mlb/nhl/epl/nfl)
- `include_snapshots` boolean: Include per-run projection snapshots
- `include_finals` boolean: Attach actual final scores (live-fetched per sport/past-date; off by default to avoid an upstream fan-out)

## Response `200`

Successful Response

- AuditResponse: Full audit response for a date range.
  - `start_date` string, date, required
  - `end_date` string, date, required
  - `sport` string, nullable
  - `total_games` integer, required
  - `total_runs` integer, required
  - `games` AuditGame[], required
    - `sport` string, required
    - `id` integer, required
    - `external_game_id` string, required
    - `game_date` string, date, required
    - `game_time_utc` string, date-time, nullable
    - `home_team` string, required
    - `away_team` string, required
    - `venue` string, nullable
    - `projected_total` number, nullable
    - `home_win_pct` number, nullable
    - `away_win_pct` number, nullable
    - `home_fair_ml` number, nullable
    - `away_fair_ml` number, nullable
    - `home_projected_runs` number, nullable
    - `away_projected_runs` number, nullable
    - `home_projected_points` number, nullable
    - `away_projected_points` number, nullable
    - `projected_spread` number, nullable
    - `home_lambda` number, nullable
    - `away_lambda` number, nullable
    - `draw_pct` number, nullable
    - `draw_fair_ml` number, nullable
    - `btts_yes_pct` number, nullable
    - `actual_home_score` integer, nullable
    - `actual_away_score` integer, nullable
    - `has_data` boolean
    - `has_projection` boolean
    - `preliminary_data` object, nullable
    - `projection_data` object, nullable
    - `odds_data` object, nullable
    - `pipeline_run_id` integer, nullable
    - `created_at` string, date-time, nullable
    - `updated_at` string, date-time, nullable
  - `pipeline_runs` AuditPipelineRun[], required
    - `id` integer, required
    - `sport` string, required
    - `pass_type` string, required
    - `game_date` string, date, required
    - `status` string, required
    - `trigger_source` string, required
    - `started_at` string, date-time, required
    - `completed_at` string, date-time, nullable
    - `error_message` string, nullable
    - `games_processed` integer, required
  - `snapshots` AuditSnapshot[], nullable
    - `id` integer, required
    - `sport` string, required
    - `game_date` string, date, required
    - `external_game_id` string, required
    - `pipeline_run_id` integer, required
    - `home_team` string, nullable
    - `away_team` string, nullable
    - `projected_total` number, nullable
    - `home_win_pct` number, nullable
    - `away_win_pct` number, nullable
    - `home_fair_ml` number, nullable
    - `away_fair_ml` number, nullable
    - `projection_data` object, nullable
    - `odds_data` object, nullable
    - `created_at` string, date-time, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/fairline/apis/fairline-api.md) · [All operations](https://skmtc.dev/fairline/apis/fairline-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fairline/apis/fairline-api/revisions/9f7ed2bfdf75?raw)