Skip to content

get_player_stats

5 creditsStats + aggregationPOST /v1/get_player_stats

Data refreshed · changelog

Weekly and season stat lines for one player: passing, rushing, receiving, defense, kicking, fantasy

Use it when you are building a player page or projection input: bio, season totals, and every weekly line in one call.

Parameters

player_idstringrequired
GSIS player id from search_players (e.g. 00-0033873)
seasonstring | numberoptional
Season year. Defaults to the player's latest season.
season_typeenum: REG | POSToptional
Regular season (default) or postseason

Notes

  • Over MCP, ask for it in plain English and the client calls get_player_stats itself. Point any MCP client at https://mcp.endzoneapi.com/mcp?key=YOUR_API_KEY.
  • Each call costs 5 credits, taken before it runs and refunded if the server errors.
  • Not the call you need? Find the right call by what you are trying to answer.

Request

curl -X POST https://mcp.endzoneapi.com/v1/get_player_stats \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "player_id": "00-0033873",
  "season": 2025
}'

Response

json
{
  "player": {
    "gsisId": "00-0033873",
    "displayName": "Patrick Mahomes",
    "firstName": "Patrick",
    "lastName": "Mahomes",
    "footballName": "Patrick",
    "suffix": null,
    "position": "QB",
    "positionGroup": "QB",
    "ngsPosition": "QB",
    "height": 74,
    "weight": 225,
    "birthDate": "1995-09-17",
    "college": "Texas Tech",
    "collegeConference": "Big Twelve Conference",
    "jerseyNumber": "15",
    "rookieSeason": 2017,
    "lastSeason": 2026,
    "latestTeam": "KC",
    "status": "ACT",
    "yearsOfExperience": 10,
    "draftYear": 2017,
    "draftRound": 1,
    "draftPick": 10,
    "draftTeam": "KC",
    "esbId": "MAH401939",
    "nflId": "44822",
    "pfrId": "MahoPa00",
    "pffId": "11765",
    "otcId": "5594",
    "espnId": "3139477",
    "smartId": "32004d41-4840-1939-e4c1-bb89191b4e71",
    "sleeperId": null,
    "active": true,
    "team_name": "Kansas City Chiefs"
  },
  "season": 2025,
  "season_type": "REG",
  "season_totals": {
    "games": 14,
    "completions": 315,
    "attempts": 502,
    "passing_yards": 3587,
    "passing_tds": 22,
    "passing_interceptions": 11,
    "sacks_suffered": 34,
    "sack_yards_lost": -193,
    "sack_fumbles": 3,
    "passing_air_yards": 4050,
    "passing_yards_after_catch": 1895,
    "passing_first_downs": 173,
    "passing_epa": 68.247,
    "passing_2pt_conversions": 2,
    "passing_10": 146,
    "passing_16": 72,
    "passing_20": 49,
    "passing_40": 8,
    "carries": 64,
    "rushing_yards": 422,
    "rushing_tds": 5,
    "rushing_first_downs": 27,
    "rushing_epa": 29.164,
    "rushing_10": 18,
    "rushing_12": 10,
    "rushing_20": 1,
    "receptions": 1,
    "targets": 1,
    "receiving_yards": -10,
    "receiving_air_yards": -8,
    "receiving_yards_after_catch": -2,
    "receiving_epa": -2.539,
    "def_tackles_solo": 1,
    "fumble_recovery_own": 3,
    "penalties": 3,
    "penalty_yards": 25,
    "fumbles_forced_by_opp": 2,
    "fumbles_not_forced": 1,
    "fumbles_total": 3,
    "fantasy_points": 284.68,
    "fantasy_points_ppr": 285.68
  },
  "weeks": [
    {
      "position": "QB",
      "positionGroup": "QB",
      "season": 2025,
      "week": 1,
      "seasonType": "REG",
      "gameId": "2025_01_KC_LAC",
      "team": "KC",
      "opponentTeam": "LAC",
      "completions": 24,
      "attempts": 39,
      "passingYards": 258,
      "passingTds": 1,
      "passingInterceptions": 0,
      "sacksSuffered": 2,
      "sackYardsLost": -9,
      "sackFumbles": 0,
      "sackFumblesLost": 0,
      "passingAirYards": 271,
      "passingYardsAfterCatch": 116,
      "passingFirstDowns": 9,
      "passingEpa": 3.4485526,
      "passingCpoe": -5.9927764,
      "passing2ptConversions": 0,
      "passing10": 9,
      "passing16": 4,
      "passing20": 3,
      "passing40": 1,
      "carries": 6,
      "rushingYards": 57,
      "rushingTds": 1,
      "rushingFumbles": 0,
      "rushingFumblesLost": 0,
      "rushingFirstDowns": 5,
      "rushingEpa": 7.2114673,
      "rushing2ptConversions": 0,
      "rushing10": 4,
      "rushing12": 1,
      "rushing20": 0,
      "rushing40": 0,
      "receptions": 0,
      "targets": 0,
      "receivingYards": 0,
      "receivingTds": 0,
      "receivingFumbles": 0,
      "receivingFumblesLost": 0,
      "receivingAirYards": 0,
      "receivingYardsAfterCatch": 0,
      "receivingFirstDowns": 0,
      "receivingEpa": null,
      "receiving2ptConversions": 0,
      "receiving10": 0,
      "receiving16": 0,
      "receiving20": 0,
      "receiving40": 0,
      "specialTeamsTds": 0,
      "defTacklesSolo": 0,
      "defTacklesWithAssist": 0,
      "defTackleAssists": 0,
      "defTacklesForLoss": 0,
      "defTacklesForLossYards": 0,
      "defFumblesForced": 0,
      "defSacks": 0,
      "defSackYards": 0,
      "defQbHits": 0,
      "defInterceptions": 0,
      "defInterceptionYards": 0,
      "defPassDefended": 0,
      "defTds": 0,
      "defFumbles": 0,
      "defSafeties": 0,
      "defPuntBlocks": 0,
      "defPatBlocks": 0,
      "defFgBlocks": 0,
      "def2ptAtts": 0,
      "def2ptMade": 0,
      "miscYards": 0,
      "fumbleRecoveryOwn": 1,
      "fumbleRecoveryYardsOwn": 0,
      "fumbleRecoveryOpp": 0,
      "fumbleRecoveryYardsOpp": 0,
      "fumbleRecoveryTds": 0,
      "penalties": 0,
      "penaltyYards": 0,
      "fumblesForcedByOpp": 0,
      "fumblesNotForced": 0,
      "fumblesOutOfBounds": 0,
      "fumblesTotal": 0,
      "fumblesLostTotal": 0,
      "puntReturns": 0,
      "puntReturnYards": 0,
      "kickoffReturns": 0,
      "kickoffReturnYards": 0,
      "fgMade": 0,
      "fgAtt": 0,
      "fgMissed": 0,
      "fgBlocked": 0,
      "fgLong": null,
      "fgPct": null,
      "fgMade019": 0,
      "fgMade2029": 0,
      "fgMade3039": 0,
      "fgMade4049": 0,
      "fgMade5059": 0,
      "fgMade60": 0,
      "fgMissed019": 0,
      "fgMissed2029": 0,
      "fgMissed3039": 0,
      "fgMissed4049": 0,
      "fgMissed5059": 0,
      "fgMissed60": 0,
      "fgMadeList": null,
      "fgMissedList": null,
      "fgBlockedList": null,
      "fgMadeDistance": 0,
      "fgMissedDistance": 0,
      "fgBlockedDistance": 0,
      "patMade": 0,
      "patAtt": 0,
      "patMissed": 0,
      "patBlocked": 0,
      "patPct": null,
      "gwfgMade": 0,
      "gwfgAtt": 0,
      "gwfgMissed": 0,
      "gwfgBlocked": 0,
      "gwfgDistance": 0,
      "ptAtt": 0,
      "ptBlocked": 0,
      "ptLong": null,
      "ptYards": 0,
      "ptInside20": 0,
      "ptOutOfBounds": 0,
      "ptDowned": 0,
      "ptTouchback": 0,
      "ptFairCaught": 0,
      "ptReturned": 0,
      "ptReturnYards": 0,
      "ptReturnTds": 0,
      "ptNetYards": 0,
      "pacr": 0.9520295,
      "racr": null,
      "targetShare": 0,
      "airYardsShare": 0,
      "wopr": 0,
      "fantasyPoints": 26.02,
      "fantasyPointsPpr": 26.02
    },
    {
      "position": "QB",
      "positionGroup": "QB",
      "season": 2025,
      "week": 2,
      "seasonType": "REG",
      "gameId": "2025_02_PHI_KC",
      "team": "KC",
      "opponentTeam": "PHI",
      "completions": 16,
      "attempts": 29,
      "passingYards": 187,
      "passingTds": 1,
      "passingInterceptions": 1,
      "sacksSuffered": 2,
      "sackYardsLost": -14,
      "sackFumbles": 0,
      "sackFumblesLost": 0,
      "passingAirYards": 309,
      "passingYardsAfterCatch": 68,
      "passingFirstDowns": 7,
      "passingEpa": -7.1535654,
      "passingCpoe": -5.841068,
      "passing2ptConversions": 0,
      "passing10": 8,
      "passing16": 5,
      "passing20": 3,
      "passing40": 1,
      "carries": 7,
      "rushingYards": 66,
      "rushingTds": 1,
      "rushingFumbles": 0,
      "rushingFumblesLost": 0,
      "rushingFirstDowns": 5,
      "rushingEpa": 6.408957,
      "rushing2ptConversions": 0,
      "rushing10": 3,
      "rushing12": 2,
      "rushing20": 1,
      "rushing40": 0,
      "receptions": 0,
      "targets": 0,
      "receivingYards": 0,
      "receivingTds": 0,
      "receivingFumbles": 0,
      "receivingFumblesLost": 0,
      "receivingAirYards": 0,
      "receivingYardsAfterCatch": 0,
      "receivingFirstDowns": 0,
      "receivingEpa": null,
      "receiving2ptConversions": 0,
      "receiving10": 0,
      "receiving16": 0,
      "receiving20": 0,
      "receiving40": 0,
      "specialTeamsTds": 0,
      "defTacklesSolo": 0,
      "defTacklesWithAssist": 0,
      "defTackleAssists": 0,
      "defTacklesForLoss": 0,
      "defTacklesForLossYards": 0,
      "defFumblesForced": 0,
      "defSacks": 0,
      "defSackYards": 0,
      "defQbHits": 0,
      "defInterceptions": 0,
      "defInterceptionYards": 0,
      "defPassDefended": 0,
      "defTds": 0,
      "defFumbles": 0,
      "defSafeties": 0,
      "defPuntBlocks": 0,
      "defPatBlocks": 0,
      "defFgBlocks": 0,
      "def2ptAtts": 0,
      "def2ptMade": 0,
      "miscYards": 0,
      "fumbleRecoveryOwn": 0,
      "fumbleRecoveryYardsOwn": 0,
      "fumbleRecoveryOpp": 0,
      "fumbleRecoveryYardsOpp": 0,
      "fumbleRecoveryTds": 0,
      "penalties": 0,
      "penaltyYards": 0,
      "fumblesForcedByOpp": 0,
      "fumblesNotForced": 0,
      "fumblesOutOfBounds": 0,
      "fumblesTotal": 0,
      "fumblesLostTotal": 0,
      "puntReturns": 0,
      "puntReturnYards": 0,
      "kickoffReturns": 0,
      "kickoffReturnYards": 0,
      "fgMade": 0,
      "fgAtt": 0,
      "fgMissed": 0,
      "fgBlocked": 0,
      "fgLong": null,
      "fgPct": null,
      "fgMade019": 0,
      "fgMade2029": 0,
      "fgMade3039": 0,
      "fgMade4049": 0,
      "fgMade5059": 0,
      "fgMade60": 0,
      "fgMissed019": 0,
      "fgMissed2029": 0,
      "fgMissed3039": 0,
      "fgMissed4049": 0,
      "fgMissed5059": 0,
      "fgMissed60": 0,
      "fgMadeList": null,
      "fgMissedList": null,
      "fgBlockedList": null,
      "fgMadeDistance": 0,
      "fgMissedDistance": 0,
      "fgBlockedDistance": 0,
      "patMade": 0,
      "patAtt": 0,
      "patMissed": 0,
      "patBlocked": 0,
      "patPct": null,
      "gwfgMade": 0,
      "gwfgAtt": 0,
      "gwfgMissed": 0,
      "gwfgBlocked": 0,
      "gwfgDistance": 0,
      "ptAtt": 0,
      "ptBlocked": 0,
      "ptLong": null,
      "ptYards": 0,
      "ptInside20": 0,
      "ptOutOfBounds": 0,
      "ptDowned": 0,
      "ptTouchback": 0,
      "ptFairCaught": 0,
      "ptReturned": 0,
      "ptReturnYards": 0,
      "ptReturnTds": 0,
      "ptNetYards": 0,
      "pacr": 0.605178,
      "racr": null,
      "targetShare": 0,
      "airYardsShare": 0,
      "wopr": 0,
      "fantasyPoints": 22.08,
      "fantasyPointsPpr": 22.08
    },
    {
      "position": "QB",
      "positionGroup": "QB",
      "season": 2025,
      "week": 3,
      "seasonType": "REG",
      "gameId": "2025_03_KC_NYG",
      "team": "KC",
      "opponentTeam": "NYG",
      "completions": 22,
      "attempts": 37,
      "passingYards": 224,
      "passingTds": 1,
      "passingInterceptions": 0,
      "sacksSuffered": 2,
      "sackYardsLost": -23,
      "sackFumbles": 2,
      "sackFumblesLost": 0,
      "passingAirYards": 319,
      "passingYardsAfterCatch": 112,
      "passingFirstDowns": 13,
      "passingEpa": 8.230807,
      "passingCpoe": -1.4937389,
      "passing2ptConversions": 0,
      "passing10": 10,
      "passing16": 5,
      "passing20": 3,
      "passing40": 0,
      "carries": 5,
      "rushingYards": 2,
      "rushingTds": 0,
      "rushingFumbles": 0,
      "rushingFumblesLost": 0,
      "rushingFirstDowns": 0,
      "rushingEpa": -1.5214161,
      "rushing2ptConversions": 0,
      "rushing10": 0,
      "rushing12": 0,
      "rushing20": 0,
      "rushing40": 0,
      "receptions": 0,
      "targets": 0,
      "receivingYards": 0,
      "receivingTds": 0,
      "receivingFumbles": 0,
      "receivingFumblesLost": 0,
      "receivingAirYards": 0,
      "receivingYardsAfterCatch": 0,
      "receivingFirstDowns": 0,
      "receivingEpa": null,
      "receiving2ptConversions": 0,
      "receiving10": 0,
      "receiving16": 0,
      "receiving20": 0,
      "receiving40": 0,
      "specialTeamsTds": 0,
      "defTacklesSolo": 0,
      "defTacklesWithAssist": 0,
      "defTackleAssists": 0,
      "defTacklesForLoss": 0,
      "defTacklesForLossYards": 0,
      "defFumblesForced": 0,
      "defSacks": 0,
      "defSackYards": 0,
      "defQbHits": 0,
      "defInterceptions": 0,
      "defInterceptionYards": 0,
      "defPassDefended": 0,
      "defTds": 0,
      "defFumbles": 0,
      "defSafeties": 0,
      "defPuntBlocks": 0,
      "defPatBlocks": 0,
      "defFgBlocks": 0,
      "def2ptAtts": 0,
      "def2ptMade": 0,
      "miscYards": 0,
      "fumbleRecoveryOwn": 1,
      "fumbleRecoveryYardsOwn": 0,
      "fumbleRecoveryOpp": 0,
      "fumbleRecoveryYardsOpp": 0,
      "fumbleRecoveryTds": 0,
      "penalties": 0,
      "penaltyYards": 0,
      "fumblesForcedByOpp": 1,
      "fumblesNotForced": 1,
      "fumblesOutOfBounds": 0,
      "fumblesTotal": 2,
      "fumblesLostTotal": 0,
      "puntReturns": 0,
      "puntReturnYards": 0,
      "kickoffReturns": 0,
      "kickoffReturnYards": 0,
      "fgMade": 0,
      "fgAtt": 0,
      "fgMissed": 0,
      "fgBlocked": 0,
      "fgLong": null,
      "fgPct": null,
      "fgMade019": 0,
      "fgMade2029": 0,
      "fgMade3039": 0,
      "fgMade4049": 0,
      "fgMade5059": 0,
      "fgMade60": 0,
      "fgMissed019": 0,
      "fgMissed2029": 0,
      "fgMissed3039": 0,
      "fgMissed4049": 0,
      "fgMissed5059": 0,
      "fgMissed60": 0,
      "fgMadeList": null,
      "fgMissedList": null,
      "fgBlockedList": null,
      "fgMadeDistance": 0,
      "fgMissedDistance": 0,
      "fgBlockedDistance": 0,
      "patMade": 0,
      "patAtt": 0,
      "patMissed": 0,
      "patBlocked": 0,
      "patPct": null,
      "gwfgMade": 0,
      "gwfgAtt": 0,
      "gwfgMissed": 0,
      "gwfgBlocked": 0,
      "gwfgDistance": 0,
      "ptAtt": 0,
      "ptBlocked": 0,
      "ptLong": null,
      "ptYards": 0,
      "ptInside20": 0,
      "ptOutOfBounds": 0,
      "ptDowned": 0,
      "ptTouchback": 0,
      "ptFairCaught": 0,
      "ptReturned": 0,
      "ptReturnYards": 0,
      "ptReturnTds": 0,
      "ptNetYards": 0,
      "pacr": 0.70219433,
      "racr": null,
      "targetShare": 0,
      "airYardsShare": 0,
      "wopr": 0,
      "fantasyPoints": 13.16,
      "fantasyPointsPpr": 13.16
    }
  ],
  "seasons": [
    {
      "season": 2026,
      "games": 7,
      "team": "KC"
    },
    {
      "season": 2025,
      "games": 14,
      "team": "KC"
    },
    {
      "season": 2024,
      "games": 16,
      "team": "KC"
    }
  ],
  "count": 14
}

Response fields

playerobject
player.gsisIdstring
player.displayNamestring
player.firstNamestring
player.lastNamestring
player.footballNamestring
player.suffixnull
player.positionstring
player.positionGroupstring
player.ngsPositionstring
player.heightnumber
player.weightnumber
player.birthDatestring
player.collegestring
player.collegeConferencestring
player.jerseyNumberstring
player.rookieSeasonnumber
player.lastSeasonnumber
player.latestTeamstring
player.statusstring
player.yearsOfExperiencenumber
player.draftYearnumber
player.draftRoundnumber
player.draftPicknumber
player.draftTeamstring
player.esbIdstring
player.nflIdstring
player.pfrIdstring
player.pffIdstring
player.otcIdstring
player.espnIdstring
player.smartIdstring
player.sleeperIdnull
player.activeboolean
player.team_namestring
seasonnumber
season_typestring
season_totalsobject
season_totals.gamesnumber
season_totals.completionsnumber

Related endpoints

Try it

500 free credits every month: 100 calls to get_player_stats, and no card.