---
title: "List Games"
method: GET
path: "/api/mlb/games"
tags: ["mlb"]
---

# List Games

`GET /api/mlb/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/mlb/games`
- Auth: HTTP bearer

## Query parameters

- `date` string, date

## Response `200`

Successful Response

- MlbSlateResponse
  - `date` string, date, required
  - `sport` string
  - `run_status` string, nullable
  - `run_completed_at` string, date-time, nullable
  - `games` MlbGameSummary[], required
    - `id` integer, required
    - `external_game_id` string, required
    - `game_date` string, date, required
    - `home_team` string, required
    - `away_team` string, required
    - `projected_total` number, nullable
    - `home_win_pct` number, nullable
    - `away_win_pct` number, nullable
    - `home_fair_ml` number, nullable
    - `away_fair_ml` number, nullable
    - `odds_data` object, nullable
    - `home_score` integer, nullable
    - `away_score` integer, nullable
    - `is_final` boolean
    - `has_projection` boolean
    - `locked` boolean
    - `game_time_utc` string, date-time, nullable
    - `game_number` integer, nullable
    - `venue` string, nullable
    - `home_pitcher_name` string, nullable
    - `away_pitcher_name` string, nullable
    - `hp_umpire_name` string, nullable
    - `home_lineup_confirmed` boolean
    - `away_lineup_confirmed` boolean
    - `home_bullpen_game` boolean
    - `away_bullpen_game` boolean
    - `home_projected_runs` number, nullable
    - `away_projected_runs` number, nullable
    - `has_data` boolean

## 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)