EndzoneAPI

https://endzoneapi.com/docs
Admin
EndzoneAPI is a football data platform that provides REST and MCP endpoints for NFL and college...
Tokens:57,854
Snippets:318
Trust Score:5.2
Update:1 day ago
Show doc for...
Tokens:
Raw
### Install endzoneapi Python client

Source: https://endzoneapi.com/docs

Install the official client from PyPI. No required dependencies. Set ENDZONEAPI_API_KEY to your key.

```bash
pip install endzoneapi
```

--------------------------------

### Authentication Header Examples

Source: https://endzoneapi.com/docs

Shows three ways to pass the API key: via x-api-key header, Authorization Bearer header, or query parameter (MCP only). Requires a verified email and an API key from the dashboard; free accounts get 500 credits monthly.

```bash
x-api-key: YOUR_API_KEY
# or
Authorization: Bearer YOUR_API_KEY
# or (MCP only)
?key=YOUR_API_KEY
```

--------------------------------

### Python client usage with pandas

Source: https://endzoneapi.com/docs

Call endpoints as methods. Example uses pandas; install with 'pip install "endzoneapi[pandas]"'.

```python
from endzoneapi import Client, to_dataframe

client = Client()

print(client.get_player_props(game_id="2025_01_KC_LAC", estimate_only=True))

props = client.get_player_props(
    game_id="2025_01_KC_LAC",
    market="player_pass_yds",
    bookmaker="draftkings",
)
df = to_dataframe(props, key="props")
print(df[["player_name", "line", "over_odds", "under_odds"]])
```

--------------------------------

### JSON response from get_prop_history

Source: https://endzoneapi.com/docs/get-prop-history

Example JSON response showing the structure of the returned data. Includes player info, a games array with line and actual values, and a summary with over rate. The note indicates this is an illustrative example with made-up data.

```json
{
  "player_id": "00-0000001",
  "player_name": "Example Player",
  "market": "player_reception_yds",
  "stat": "receiving yards",
  "bookmaker": null,
  "games": [
    {
      "game_id": "2024_01_KC_BAL",
      "game_date": "2024-09-05",
      "line": 62.5,
      "open_line": 58.5,
      "over_odds": -110,
      "under_odds": -110,
      "books": 7,
      "actual": 71,
      "result": "over",
      "margin": 8.5
    }
  ],
  "count": 1,
  "summary": {
    "games": 1,
    "graded": 1,
    "overs": 1,
    "unders": 0,
    "pushes": 0,
    "over_rate": 1,
    "avg_line": 62.5,
    "avg_actual": 71
  },
  "truncated": false,
  "next_from_date": null,
  "note": "Illustrative example: made-up player and numbers, to show the shape of a response."
}
```

--------------------------------

### JSON response for get_game_detail

Source: https://endzoneapi.com/docs/get-game-detail

Example response containing game details, team info, consensus closing odds, and team stats for both teams.

```json
{
  "game": {
    "game_id": "2025_01_KC_LAC",
    "season": 2025,
    "game_type": "REG",
    "week": 1,
    "gameday": "2025-09-05",
    "weekday": "Friday",
    "kickoff": "2025-09-06T00:00:00.000Z",
    "away_team": "KC",
    "home_team": "LAC",
    "away_score": 21,
    "home_score": 27,
    "result": 6,
    "total": 48,
    "overtime": 0,
    "status": "FINAL",
    "location": "Neutral",
    "stadium": "SoFi Stadium",
    "roof": "dome",
    "surface": null,
    "temp": null,
    "wind": null,
    "div_game": true,
    "away_rest": 7,
    "home_rest": 7,
    "spread_line": -3,
    "total_line": 47.5,
    "away_moneyline": -175,
    "home_moneyline": 145,
    "away_qb_name": "Patrick Mahomes",
    "home_qb_name": "Justin Herbert",
    "away_qb_id": "00-0033873",
    "home_qb_id": "00-0036355",
    "away_coach": "Andy Reid",
    "home_coach": "Jim Harbaugh",
    "referee": "Carl Cheffers",
    "espn_id": "401772714",
    "pfr_id": "202509050sdg"
  },
  "home_team": {
    "abbrev": "LAC",
    "name": "Los Angeles Chargers",
    "nick": "Chargers",
    "conference": "AFC",
    "division": "AFC West",
    "teamId": "4400",
    "color": "#007BC7",
    "color2": "#ffc20e",
    "color3": "#ffb612",
    "color4": "#001532",
    "logoEspn": "https://a.espncdn.com/i/teamlogos/nfl/500/lac.png",
    "logoWikipedia": "https://upload.wikimedia.org/wikipedia/en/thumb/7/72/NFL_Chargers_logo.svg/100px-NFL_Chargers_logo.svg.png",
    "logoSquared": "https://github.com/nflverse/nflverse-pbp/raw/master/squared_logos/LAC.png",
    "wordmark": "https://github.com/nflverse/nflverse-pbp/raw/master/wordmarks/LAC.png",
    "active": true,
    "relocatedTo": null
  },
  "away_team": {
    "abbrev": "KC",
    "name": "Kansas City Chiefs",
    "nick": "Chiefs",
    "conference": "AFC",
    "division": "AFC West",
    "teamId": "2310",
    "color": "#E31837",
    "color2": "#FFB612",
    "color3": "#000000",
    "color4": "#e31837",
    "logoEspn": "https://a.espncdn.com/i/teamlogos/nfl/500/kc.png",
    "logoWikipedia": "https://upload.wikimedia.org/wikipedia/en/thumb/e/e1/Kansas_City_Chiefs_logo.svg/100px-Kansas_City_Chiefs_logo.svg.png",
    "logoSquared": "https://github.com/nflverse/nflverse-pbp/raw/master/squared_logos/KC.png",
    "wordmark": "https://github.com/nflverse/nflverse-pbp/raw/master/wordmarks/KC.png",
    "active": true,
    "relocatedTo": null
  },
  "consensus_closing": {
    "spread_line": -3,
    "total_line": 47.5,
    "home_moneyline": 145,
    "away_moneyline": -175
  },
  "team_stats": {
    "home": {
      "id": 18,
      "season": 2025,
      "week": 1,
      "team": "LAC",
      "seasonType": "REG",
      "gameId": "2025_01_KC_LAC",
      "opponentTeam": "KC",
      "completions": 25,
      "attempts": 34,
      "passingYards": 318,
      "passingTds": 3,
      "passingInterceptions": 0,
      "sacksSuffered": 3,
      "sackYardsLost": -14,
      "sackFumbles": 0,
      "sackFumblesLost": 0,
      "passingAirYards": 342,
      "passingYardsAfterCatch": 134,
      "passingFirstDowns": 16,
      "passingEpa": 17.567263,
      "passingCpoe": 5.788768,
      "passing2ptConversions": 0,
      "passing10": 12,
      "passing16": 7,
      "passing20": 4,
      "passing40": 0,
      "carries": 25,
      "rushingYards": 90,
      "rushingTds": 0,
      "rushingFumbles": 0,
      "rushingFumblesLost": 0,
      "rushingFirstDowns": 6,
      "rushingEpa": -0.23139648,
      "rushing2ptConversions": 0,
      "rushing10": 2,
      "rushing12": 1,
      "rushing20": 0,
      "rushing40": 0,
      "receptions": 25,
      "targets": 34,
      "receivingYards": 318,
      "receivingTds": 3,
      "receivingFumbles": 1,
      "receivingFumblesLost": 0,
      "receivingAirYards": 342,
      "receivingYardsAfterCatch": 134,
      "receivingFirstDowns": 16,
      "receivingEpa": 21.656591,
      "receiving2ptConversions": 0,
      "receiving10": 12,
      "receiving16": 7,
      "receiving20": 4,
      "receiving40": 0
    }
  }
}
```

--------------------------------

### cURL request to get_player_props

Source: https://endzoneapi.com/docs/get-player-props

Example cURL command to POST to the get_player_props endpoint with a game_id and market. Requires an API key in the x-api-key header. Each call costs 10 credits.

```bash
curl -X POST https://mcp.endzoneapi.com/v1/get_player_props \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "game_id": "2025_01_KC_LAC",
  "market": "player_pass_yds"
}'
```

--------------------------------

### Response for get_standings

Source: https://endzoneapi.com/docs

Example JSON response (first 14 lines) for the get_standings call. Full response available at the provided link.

```json
{
  "season": 2025,
  "standings": [
    {
      "team": "DEN",
      "name": "Denver Broncos",
      "conference": "AFC",
      "division": "AFC West",
      "division_rank": 1,
      "conference_rank": 1,
      "division_tiebreaker": "record",
      "conference_tiebreaker": "common games",
      "wins": 14,
      "losses": 3,
  ...
```

--------------------------------

### JSON Response from get_plays Endpoint

Source: https://endzoneapi.com/docs/get-plays

Example response containing an array of play objects with detailed play-by-play data, a summary with aggregate stats, a count, and a next_offset for pagination.

```json
{
  "plays": [
    {
      "game_id": "2025_01_KC_LAC",
      "play_id": 40,
      "season": 2025,
      "week": 1,
      "posteam": "KC",
      "defteam": "LAC",
      "qtr": 1,
      "time": "15:00",
      "down": null,
      "ydstogo": 0,
      "yardline_100": 35,
      "yrdln": "LAC 35",
      "play_type": "kickoff",
      "desc": "11-C.Dicker kicks 59 yards from LAC 35 to KC 6. 80-T.Thornton pushed ob at KC 48 for 42 yards (24-B.St-Juste). PENALTY on KC-2-J.Williams, Offensive Holding, 10 yards, enforced at KC 34.",
      "yards_gained": 0,
      "epa": -0.24012075,
      "wpa": 0,
      "wp": 0.43320796,
      "vegas_wp": 0.61365855,
      "success": 0,
      "first_down": 0,
      "touchdown": 0,
      "interception": 0,
      "fumble_lost": 0,
      "sack": 0,
      "penalty": 1,
      "penalty_type": "Offensive Holding",
      "shotgun": 0,
      "no_huddle": 0,
      "pass_length": null,
      "pass_location": null,
      "air_yards": null,
      "yards_after_catch": null,
      "run_location": null,
      "run_gap": null,
      "cpoe": null,
      "xpass": null,
      "passer_player_id": null,
      "passer_player_name": null,
      "rusher_player_id": null,
      "rusher_player_name": null,
      "receiver_player_id": null,
      "receiver_player_name": null,
      "posteam_score": 0,
      "defteam_score": 0,
      "score_differential": 0,
      "drive": 1,
      "drive_result": "Punt",
      "series_result": "Punt"
    },
    {
      "game_id": "2025_01_KC_LAC",
      "play_id": 79,
      "season": 2025,
      "week": 1,
      "posteam": "KC",
      "defteam": "LAC",
      "qtr": 1,
      "time": "14:52",
      "down": 1,
      "ydstogo": 10,
      "yardline_100": 76,
      "yrdln": "KC 24",
      "play_type": "run",
      "desc": "(14:52) (Shotgun) 10-I.Pacheco right guard to KC 28 for 4 yards (32-A.Gilman; 0-D.Henley).",
      "yards_gained": 4,
      "epa": -0.008932982,
      "wpa": -0.010726303,
      "wp": 0.43320796,
      "vegas_wp": 0.6127665,
      "success": 0,
      "first_down": 0,
      "touchdown": 0,
      "interception": 0,
      "fumble_lost": 0,
      "sack": 0,
      "penalty": 0,
      "penalty_type": null,
      "shotgun": 1,
      "no_huddle": 0,
      "pass_length": null,
      "pass_location": null,
      "air_yards": null,
      "yards_after_catch": null,
      "run_location": "right",
      "run_gap": "guard",
      "cpoe": null,
      "xpass": 0.48951253,
      "passer_player_id": null,
      "passer_player_name": null,
      "rusher_player_id": "00-0037197",
      "rusher_player_name": "I.Pacheco",
      "receiver_player_id": null,
      "receiver_player_name": null,
      "posteam_score": 0,
      "defteam_score": 0,
      "score_differential": 0,
      "drive": 1,
      "drive_result": "Punt",
      "series_result": "Punt"
    },
    {
      "game_id": "2025_01_KC_LAC",
      "play_id": 101,
      "season": 2025,
      "week": 1,
      "posteam": "KC",
      "defteam": "LAC",
      "qtr": 1,
      "time": "14:21",
      "down": 2,
      "ydstogo": 6,
      "yardline_100": 72,
      "yrdln": "KC 28",
      "play_type": "run",
      "desc": "(14:21) (Shotgun) 1-X.Worthy right end to KC 28 for no gain (52-K.Mack).",
      "yards_gained": 0,
      "epa": -0.806627,
      "wpa": -0.0171507,
      "wp": 0.42248166,
      "vegas_wp": 0.6049587,
      "success": 0,
      "first_down": 0,
      "touchdown": 0,
      "interception": 0,
      "fumble_lost": 0,
      "sack": 0,
      "penalty": 0,
      "penalty_type": null,
      "shotgun": 1,
      "no_huddle": 0,
      "pass_length": null,
      "pass_location": null,
      "air_yards": null,
      "yards_after_catch": null,
      "run_location": "right",
      "run_gap": "end",
      "cpoe": null,
      "xpass": 0.6220576,
      "passer_player_id": null,
      "passer_player_name": null,
      "rusher_player_id": "00-0039894",
      "rusher_player_name": "X.Worthy",
      "receiver_player_id": null,
      "receiver_player_name": null,
      "posteam_score": 0,
      "defteam_score": 0,
      "score_differential": 0,
      "drive": 1,
      "drive_result": "Punt",
      "series_result": "Punt"
    }
  ],
  "summary": {
    "plays": 5,
    "epa_total": -2.6,
    "epa_per_play": -0.519,
    "success_rate": 0.2
  },
  "count": 5,
  "next_offset": 5
}
```

--------------------------------

### get_game_detail

Source: https://endzoneapi.com/docs

Returns full game detail with team stats, starting QBs, odds, weather, and officials. Costs 10 credits per call.

```APIDOC
## get_game_detail

### Description
Returns full game detail with team stats, starting QBs, odds, weather, and officials.

### Credit Cost
10 credits per call

### Documentation Link
https://endzoneapi.com/docs/get-game-detail
```

--------------------------------

### cURL request to get_alt_lines

Source: https://endzoneapi.com/docs/get-alt-lines

Example cURL command to call the get_alt_lines endpoint. It requires a valid API key and a game_id. The example uses market 'alternate_spreads' and bookmaker 'draftkings'. Each call costs 10 credits, taken before it runs and refunded if the server errors.

```bash
curl -X POST https://mcp.endzoneapi.com/v1/get_alt_lines \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "game_id": "2025_01_KC_LAC",
  "market": "alternate_spreads",
  "bookmaker": "draftkings"
}'
```

--------------------------------

### JSON response for get_schedule

Source: https://endzoneapi.com/docs/get-schedule

Example response from the get_schedule endpoint showing a list of upcoming games with details such as teams, kickoff times, lines, and quarterback information. The response includes a count of total games.

```json
{
  "season": 2026,
  "week": null,
  "days": 7,
  "upcoming_games": [
    {
      "game_id": "2026_06_ARI_LA",
      "season": 2026,
      "game_type": "REG",
      "week": 6,
      "gameday": "2026-10-18",
      "weekday": "Sunday",
      "kickoff": "2026-10-18T20:05:00.000Z",
      "away_team": "ARI",
      "home_team": "LA",
      "away_score": null,
      "home_score": null,
      "result": null,
      "total": null,
      "overtime": null,
      "status": "FUT",
      "location": "Home",
      "stadium": "SoFi Stadium",
      "roof": "dome",
      "surface": "matrixturf",
      "temp": null,
      "wind": null,
      "div_game": true,
      "away_rest": 7,
      "home_rest": 6,
      "spread_line": 12.5,
      "total_line": 51.5,
      "away_moneyline": 550,
      "home_moneyline": -800,
      "away_qb_name": "Jacoby Brissett",
      "home_qb_name": "Matthew Stafford",
      "away_qb_id": "00-0033119",
      "home_qb_id": "00-0026498",
      "away_coach": "Jonathan Gannon",
      "home_coach": "Sean McVay",
      "referee": null,
      "espn_id": "401873004",
      "pfr_id": "202610180ram"
    },
    {
      "game_id": "2026_06_LAC_KC",
      "season": 2026,
      "game_type": "REG",
      "week": 6,
      "gameday": "2026-10-18",
      "weekday": "Sunday",
      "kickoff": "2026-10-18T20:25:00.000Z",
      "away_team": "LAC",
      "home_team": "KC",
      "away_score": null,
      "home_score": null,
      "result": null,
      "total": null,
      "overtime": null,
      "status": "FUT",
      "location": "Home",
      "stadium": "GEHA Field at Arrowhead Stadium",
      "roof": "outdoors",
      "surface": "grass",
      "temp": null,
      "wind": null,
      "div_game": true,
      "away_rest": 7,
      "home_rest": 14,
      "spread_line": 7.5,
      "total_line": 41.5,
      "away_moneyline": 330,
      "home_moneyline": -425,
      "away_qb_name": "Justin Herbert",
      "home_qb_name": "Patrick Mahomes",
      "away_qb_id": "00-0036355",
      "home_qb_id": "00-0033873",
      "away_coach": "Jim Harbaugh",
      "home_coach": "Andy Reid",
      "referee": null,
      "espn_id": "401873006",
      "pfr_id": "202610180kan"
    },
    {
      "game_id": "2026_06_BUF_LV",
      "season": 2026,
      "game_type": "REG",
      "week": 6,
      "gameday": "2026-10-18",
      "weekday": "Sunday",
      "kickoff": "2026-10-18T20:25:00.000Z",
      "away_team": "BUF",
      "home_team": "LV",
      "away_score": null,
      "home_score": null,
      "result": null,
      "total": null,
      "overtime": null,
      "status": "FUT",
      "location": "Home",
      "stadium": "Allegiant Stadium",
      "roof": "dome",
      "surface": "grass",
      "temp": null,
      "wind": null,
      "div_game": false,
      "away_rest": 6,
      "home_rest": 7,
      "spread_line": -5.5,
      "total_line": 53.5,
      "away_moneyline": -258,
      "home_moneyline": 210,
      "away_qb_name": "Josh Allen",
      "home_qb_name": "Kirk Cousins",
      "away_qb_id": "00-0034857",
      "home_qb_id": "00-0029604",
      "away_coach": "Sean McDermott",
      "home_coach": "Klint Kubliak",
      "referee": null,
      "espn_id": "401873005",
      "pfr_id": "202610180rai"
    }
  ],
  "count": 17
}
```

--------------------------------

### JSON response for get_snap_counts

Source: https://endzoneapi.com/docs/get-snap-counts

Example response showing snap counts for players in the specified game. Includes filters, snap counts array, count, and a note about PFR player IDs.

```json
{
  "filters": {
    "game_id": "2025_01_KC_LAC",
    "player_id": null,
    "team": null,
    "season": null,
    "week": null
  },
  "snap_counts": [
    {
      "game_id": "2025_01_KC_LAC",
      "season": 2025,
      "week": 1,
      "team": "KC",
      "opponent": "LAC",
      "player": "Trey Smith",
      "pfr_player_id": "SmitTr05",
      "position": "G",
      "offense_snaps": 61,
      "offense_pct": 1,
      "defense_snaps": 0,
      "defense_pct": 0,
      "st_snaps": 4,
      "st_pct": 0.16
    },
    {
      "game_id": "2025_01_KC_LAC",
      "season": 2025,
      "week": 1,
      "team": "KC",
      "opponent": "LAC",
      "player": "Creed Humphrey",
      "pfr_player_id": "HumpCr00",
      "position": "C",
      "offense_snaps": 61,
      "offense_pct": 1,
      "defense_snaps": 0,
      "defense_pct": 0,
      "st_snaps": 4,
      "st_pct": 0.16
    },
    {
      "game_id": "2025_01_KC_LAC",
      "season": 2025,
      "week": 1,
      "team": "KC",
      "opponent": "LAC",
      "player": "Patrick Mahomes",
      "pfr_player_id": "MahoPa00",
      "position": "QB",
      "offense_snaps": 61,
      "offense_pct": 1,
      "defense_snaps": 0,
      "defense_pct": 0,
      "st_snaps": 0,
      "st_pct": 0
    }
  ],
  "count": 5,
  "note": "Snap counts are keyed by PFR player id (see pfr_id on search_players)."
}
```

--------------------------------

### cURL request to get_prop_history

Source: https://endzoneapi.com/docs/get-prop-history

Example cURL command to call the get_prop_history endpoint. Replace YOUR_API_KEY with your actual key. The request uses POST with a JSON body containing player_id and market.

```bash
curl -X POST https://mcp.endzoneapi.com/v1/get_prop_history \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "player_id": "00-0000001",
  "market": "player_reception_yds"
}'
```

--------------------------------

### JSON response from get_injuries

Source: https://endzoneapi.com/docs/get-injuries

Example response showing injury report data for team KC, week 9, season 2025. Includes player details, practice status, and game type.

```json
{
  "season": 2025,
  "week": 9,
  "injuries": [
    {
      "team": "KC",
      "player_id": "00-0037197",
      "name": "Isiah Pacheco",
      "position": "RB",
      "report_status": "Out",
      "report_primary_injury": "Knee",
      "report_secondary_injury": null,
      "practice_status": "Did Not Participate In Practice",
      "practice_primary_injury": "Knee",
      "game_type": "REG"
    },
    {
      "team": "KC",
      "player_id": "00-0040116",
      "name": "Josh Simmons",
      "position": "T",
      "report_status": "Out",
      "report_primary_injury": "Not injury related - personal matter",
      "report_secondary_injury": null,
      "practice_status": "Did Not Participate In Practice",
      "practice_primary_injury": "Not injury related - personal matter",
      "game_type": "REG"
    },
    {
      "team": "KC",
      "player_id": "00-0036557",
      "name": "Jaylon Moore",
      "position": "T",
      "report_status": "Questionable",
      "report_primary_injury": "Illness",
      "report_secondary_injury": null,
      "practice_status": "Did Not Participate In Practice",
      "practice_primary_injury": "Illness",
      "game_type": "REG"
    }
  ],
  "count": 10
}
```

--------------------------------

### Get Plays Response Fields

Source: https://endzoneapi.com/docs/get-plays

Describes the structure of the response object returned by the Get Plays endpoint, including all fields in the plays array.

```APIDOC
## Get Plays Response Fields

### Description
This endpoint returns a list of plays with detailed play-by-play data. The response contains an array of play objects, each with fields for game context, play outcome, and advanced metrics.

### Response
#### Success Response (200)
- **plays[]** (array) - List of play objects.
- **plays[].game_id** (string) - The unique identifier for the game.
- **plays[].play_id** (number) - The unique identifier for the play.
- **plays[].season** (number) - The season year.
- **plays[].week** (number) - The week number of the season.
- **plays[].posteam** (string) - The team with possession.
- **plays[].defteam** (string) - The defensive team.
- **plays[].qtr** (number) - The quarter of the game.
- **plays[].time** (string) - The time remaining in the quarter.
- **plays[].down** (null) - The down (always null in this response).
- **plays[].ydstogo** (number) - Yards to go for a first down.
- **plays[].yardline_100** (number) - Yard line from the opponent's goal (0-100).
- **plays[].yrdln** (string) - The yard line description.
- **plays[].play_type** (string) - The type of play (e.g., pass, run).
- **plays[].desc** (string) - The play description.
- **plays[].yards_gained** (number) - Net yards gained on the play.
- **plays[].epa** (number) - Expected points added.
- **plays[].wpa** (number) - Win probability added.
- **plays[].wp** (number) - Win probability before the play.
- **plays[].vegas_wp** (number) - Vegas win probability.
- **plays[].success** (number) - Whether the play was successful (1 or 0).
- **plays[].first_down** (number) - Whether a first down was achieved (1 or 0).
- **plays[].touchdown** (number) - Whether a touchdown was scored (1 or 0).
- **plays[].interception** (number) - Whether an interception occurred (1 or 0).
- **plays[].fumble_lost** (number) - Whether a fumble was lost (1 or 0).
- **plays[].sack** (number) - Whether a sack occurred (1 or 0).
- **plays[].penalty** (number) - Whether a penalty occurred (1 or 0).
- **plays[].penalty_type** (string) - The type of penalty.
- **plays[].shotgun** (number) - Whether the play was from shotgun formation (1 or 0).
- **plays[].no_huddle** (number) - Whether the play was no-huddle (1 or 0).
- **plays[].pass_length** (null) - The length of the pass (always null).
- **plays[].pass_location** (null) - The location of the pass (always null).
- **plays[].air_yards** (null) - Air yards on the pass (always null).
- **plays[].yards_after_catch** (null) - Yards after catch (always null).
- **plays[].run_location** (null) - The run location (always null).
- **plays[].run_gap** (null) - The run gap (always null).
- **plays[].cpoe** (null) - Completion percentage over expected (always null).
- **plays[].xpass** (null) - Expected pass probability (always null).
- **plays[].passer_player_id** (null) - The passer's player ID (always null).
- **plays[].passer_player_name** (null) - The passer's name (always null).

#### Response Example
```json
{
  "plays": [
    {
      "game_id": "2023090700",
      "play_id": 1,
      "season": 2023,
      "week": 1,
      "posteam": "KC",
      "defteam": "DET",
      "qtr": 1,
      "time": "15:00",
      "down": null,
      "ydstogo": 10,
      "yardline_100": 25,
      "yrdln": "KC 25",
      "play_type": "run",
      "desc": "(15:00) P.Mahomes pass short left to I.Pacheco to KC 30 for 5 yards.",
      "yards_gained": 5,
      "epa": 0.5,
      "wpa": 0.01,
      "wp": 0.5,
      "vegas_wp": 0.5,
      "success": 1,
      "first_down": 0,
      "touchdown": 0,
      "interception": 0,
      "fumble_lost": 0,
      "sack": 0,
      "penalty": 0,
      "penalty_type": null,
      "shotgun": 0,
      "no_huddle": 0,
      "pass_length": null,
      "pass_location": null,
      "air_yards": null,
      "yards_after_catch": null,
      "run_location": null,
      "run_gap": null,
      "cpoe": null,
      "xpass": null,
      "passer_player_id": null,
      "passer_player_name": null
    }
  ]
}
```

```

--------------------------------

### Get Head-to-Head Response Fields

Source: https://endzoneapi.com/docs/get-head-to-head

Describes the structure of the response returned by the Get Head-to-Head endpoint, including team names, head-to-head record, total games, average margin, and an array of game objects with detailed game information.

```APIDOC
## Get Head-to-Head Response Fields

### Description
This endpoint returns head-to-head game records and detailed game information between two teams.

### Response Fields

- **team1** (string) - The first team identifier.
- **team2** (string) - The second team identifier.
- **record** (object) - Head-to-head record.
  - **record.KC** (number) - Wins for team1 (KC).
  - **record.BUF** (number) - Wins for team2 (BUF).
  - **record.ties** (number) - Number of ties.
- **total_games** (number) - Total number of games played between the two teams.
- **avg_margin_team1** (number) - Average margin of victory for team1.
- **games[]** (array) - List of game objects.
  - **games[].game_id** (string) - Unique identifier for the game.
  - **games[].season** (number) - Season year.
  - **games[].game_type** (string) - Type of game (e.g., regular, playoff).
  - **games[].week** (number) - Week number.
  - **games[].gameday** (string) - Date of the game.
  - **games[].weekday** (string) - Day of the week.
  - **games[].kickoff** (string) - Kickoff time.
  - **games[].away_team** (string) - Away team identifier.
  - **games[].home_team** (string) - Home team identifier.
  - **games[].away_score** (number) - Away team score.
  - **games[].home_score** (number) - Home team score.
  - **games[].result** (number) - Result indicator (e.g., 1 for win, 0 for loss).
  - **games[].total** (number) - Total points scored in the game.
  - **games[].overtime** (number) - Overtime indicator (1 if overtime, 0 otherwise).
  - **games[].status** (string) - Game status (e.g., final, scheduled).
  - **games[].location** (string) - Location of the game.
  - **games[].stadium** (string) - Stadium name.
  - **games[].roof** (string) - Roof type (e.g., dome, open).
  - **games[].surface** (string) - Playing surface.
  - **games[].temp** (number) - Temperature at game time.
  - **games[].wind** (number) - Wind speed.
  - **games[].div_game** (boolean) - Whether the game is a division game.
  - **games[].away_rest** (number) - Days of rest for away team.
  - **games[].home_rest** (number) - Days of rest for home team.
  - **games[].spread_line** (number) - Spread line.
  - **games[].total_line** (number) - Total line.
  - **games[].away_moneyline** (number) - Moneyline for away team.
  - **games[].home_moneyline** (number) - Moneyline for home team.
  - **games[].away_qb_name** (string) - Away team starting quarterback name.
  - **games[].home_qb_name** (string) - Home team starting quarterback name.
  - **games[].away_qb_id** (string) - Away team starting quarterback ID.

### Related Endpoints
- [get_game_detail](https://endzoneapi.com/docs/get-game-detail) - Takes the `game_id` this one returns. Full game detail with team stats, starting QBs, odds, weather, and officials.
- [get_alt_lines](https://endzoneapi.com/docs/get-alt-lines) - Takes the `game_id` this one returns. Alternate spreads and totals by sportsbook: every point on the ladder, opening and closing, from the 2023 season to the current one.
- [get_standings](https://endzoneapi.com/docs/get-standings) - Filters by the same `season`. Standings and playoff seeding by the NFL tiebreaking procedure, with the step that decided each rank.
- [search_players](https://endzoneapi.com/docs/search-players) - Filters by the same `limit`. Find players by name, team, or position.
```

--------------------------------

### JSON response from get_player_props

Source: https://endzoneapi.com/docs/get-player-props

Example JSON response showing player prop lines for a game, including snapshot_type, games, props array, and count. The response includes player names, gsis_id, market, bookmaker, line, over/under odds, captured_at, and source.

```json
{
  "snapshot_type": "closing",
  "games": 1,
  "props": [
    {
      "game_id": "2025_01_KC_LAC",
      "player_name": "Justin Herbert",
      "gsis_id": "00-0036355",
      "market": "player_pass_yds",
      "bookmaker": "betmgm",
      "line": 236.5,
      "over_odds": -115,
      "under_odds": -118,
      "captured_at": "2025-09-05 21:53:39+00",
      "source": "the_odds_api"
    },
    {
      "game_id": "2025_01_KC_LAC",
      "player_name": "Patrick Mahomes",
      "gsis_id": "00-0033873",
      "market": "player_pass_yds",
      "bookmaker": "betmgm",
      "line": 245.5,
      "over_odds": -135,
      "under_odds": 100,
      "captured_at": "2025-09-05 21:53:39+00",
      "source": "the_odds_api"
    },
    {
      "game_id": "2025_01_KC_LAC",
      "player_name": "Justin Herbert",
      "gsis_id": "00-0036355",
      "market": "player_pass_yds",
      "bookmaker": "betonlineag",
      "line": 233.5,
      "over_odds": -118,
      "under_odds": -110,
      "captured_at": "2025-09-05 21:53:39+00",
      "source": "the_odds_api"
    }
  ],
  "count": 14
}
```

--------------------------------

### Get Player Stats

Source: https://endzoneapi.com/docs/get-player-stats

Returns detailed player information and season statistics for a given player.

```APIDOC
## Get Player Stats

### Description
Returns detailed player information and season statistics for a given player.

### Response Fields

- `player` (object) - Player details
  - `player.gsisId` (string) - GSIS ID
  - `player.displayName` (string) - Display name
  - `player.firstName` (string) - First name
  - `player.lastName` (string) - Last name
  - `player.footballName` (string) - Football name
  - `player.suffix` (null) - Suffix
  - `player.position` (string) - Position
  - `player.positionGroup` (string) - Position group
  - `player.ngsPosition` (string) - NGS position
  - `player.height` (number) - Height
  - `player.weight` (number) - Weight
  - `player.birthDate` (string) - Birth date
  - `player.college` (string) - College
  - `player.collegeConference` (string) - College conference
  - `player.jerseyNumber` (string) - Jersey number
  - `player.rookieSeason` (number) - Rookie season
  - `player.lastSeason` (number) - Last season
  - `player.latestTeam` (string) - Latest team
  - `player.status` (string) - Status
  - `player.yearsOfExperience` (number) - Years of experience
  - `player.draftYear` (number) - Draft year
  - `player.draftRound` (number) - Draft round
  - `player.draftPick` (number) - Draft pick
  - `player.draftTeam` (string) - Draft team
  - `player.esbId` (string) - ESB ID
  - `player.nflId` (string) - NFL ID
  - `player.pfrId` (string) - PFR ID
  - `player.pffId` (string) - PFF ID
  - `player.otcId` (string) - OTC ID
  - `player.espnId` (string) - ESPN ID
  - `player.smartId` (string) - Smart ID
  - `player.sleeperId` (null) - Sleeper ID
  - `player.active` (boolean) - Active flag
  - `player.team_name` (string) - Team name
- `season` (number) - Season year
- `season_type` (string) - Season type (e.g., regular, postseason)
- `season_totals` (object) - Season totals
  - `season_totals.games` (number) - Games played
  - `season_totals.completions` (number) - Completions

### Related Endpoints

- [search_players](https://endzoneapi.com/docs/search-players) - Find players by name, team, or position
- [get_injuries](https://endzoneapi.com/docs/get-injuries) - Injury report by team and week
- [get_standings](https://endzoneapi.com/docs/get-standings) - Standings and playoff seeding
- [get_team_stats](https://endzoneapi.com/docs/get-team-stats) - Team totals and per-week lines
```

--------------------------------

### First call: get_standings with cURL

Source: https://endzoneapi.com/docs

POST request to the get_standings endpoint. Replace YOUR_API_KEY with your key. Costs 2 credits.

```bash
curl -X POST https://mcp.endzoneapi.com/v1/get_standings \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "season": 2025,
  "division": "AFC West"
}'
```

--------------------------------

### cURL request to search_players

Source: https://endzoneapi.com/docs/search-players

Sends a POST request to search for a player by name. Requires an API key in the x-api-key header. The example searches for 'Mahomes'.

```bash
curl -X POST https://mcp.endzoneapi.com/v1/search_players \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "query": "Mahomes"
}'
```
Tokens:
Raw