# NFL API: Get team roster > Gets an NFL team's current NFL.com roster by team name, nickname or city. You can limit it to offense, defense or special teams. Released players are left out. Unofficial. Not affiliated with or endorsed by NFL. - Page: https://fous.com/methods/nfl.com/get-team-roster - Method: `nfl.com/get_team_roster`, version 1 - Website: nfl.com - Returns: team, team link, players with jersey number, position, status, height, weight, age, experience, college - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1ยข with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `team` | string | yes | `"Green Bay Packers"` | Team name, nickname, or city, for example Green Bay Packers or Packers. | | `unit` | string | no | | Roster unit to include, for example offense. Defaults to all. One of "all", "offense", "defense", "special_teams". Default "all". | ## Output From a run on Oct 23, 2026, shortened. Its input: ```json { "team": "Green Bay Packers" } ``` Its output: ```json { "team": "Green Bay Packers", "players": [ { "age": 26, "name": "Sean Rhyan", "height": "6 ft 5 in", "status": "Active", "college": "UCLA", "position": "Center", "player_link": "https://www.nfl.com/players/sean-rhyan/", "jersey_number": 75, "position_code": "C", "weight_pounds": 320, "years_experience": 5 }, { "age": 21, "name": "Brandon Cisse", "height": "6 ft 0 in", "status": "Active", "college": "South Carolina", "position": "Cornerback", "player_link": "https://www.nfl.com/players/brandon-cisse/", "jersey_number": 2, "position_code": "CB", "weight_pounds": 189, "years_experience": 0 }, { "age": 23, "name": "Domani Jackson", "height": "6 ft 1 in", "status": "Practice Squad", "college": "Alabama", "position": "Cornerback", "player_link": "https://www.nfl.com/players/domani-jackson/", "jersey_number": 20, "position_code": "CB", "weight_pounds": 194, "years_experience": 0 } ], "team_link": "https://www.nfl.com/teams/green-bay-packers/" } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"nfl.com/get_team_roster","input":{"team":"Green Bay Packers"}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - Who is on the Packers offense right now? I want the current roster with jersey numbers and positions. - Show me the Chicago Bears defensive players, including height, weight, age, and college. - Can you pull the current special teams unit for the Dallas Cowboys from NFL.com? - I need the full active roster for the Bengals, excluding anyone who has been released. - Give me the defense roster for the Seattle team, listing each player's experience and college. ## Input schema ```json { "type": "object", "required": [ "team" ], "properties": { "team": { "type": "string", "description": "Team name, nickname, or city, for example Green Bay Packers or Packers." }, "unit": { "enum": [ "all", "offense", "defense", "special_teams" ], "type": "string", "default": "all", "description": "Roster unit to include, for example offense. Defaults to all." } } } ``` ## Output schema ```json { "type": "object", "required": [ "team", "team_link", "players" ], "properties": { "team": { "type": "string" }, "players": { "type": "array", "items": { "type": "object", "properties": { "age": { "type": [ "integer", "null" ] }, "name": { "type": "string" }, "height": { "type": [ "string", "null" ] }, "status": { "type": [ "string", "null" ] }, "college": { "type": [ "string", "null" ] }, "position": { "type": [ "string", "null" ] }, "player_link": { "type": "string" }, "jersey_number": { "type": [ "integer", "null" ] }, "position_code": { "type": [ "string", "null" ] }, "weight_pounds": { "type": [ "integer", "null" ] }, "years_experience": { "type": [ "integer", "null" ] } } } }, "team_link": { "type": "string" } } } ``` ## See more - [NFL API: Get player stats](https://fous.com/methods/nfl.com/get-player-stats.md): Gets a named NFL player's season and career stats, with profile details. Active players are preferred when names match. - [NFL API: Get scores](https://fous.com/methods/nfl.com/get-scores.md): Gets NFL scores and scheduled games for the week that contains a date. You can keep only one team's games. Kickoff times are in US Eastern time unless you choose another time zone. - [NFL API: Get standings](https://fous.com/methods/nfl.com/get-standings.md): Gets NFL regular-season standings by conference and division for a season, with clinch status when shown. - [NHL API: Get player stats](https://fous.com/methods/nhl.com/get-player-stats.md): Looks up an NHL player by name, link or ID and returns the profile with regular-season stats for a season and career totals. - [NBA API: Get player by name](https://fous.com/methods/nba.com/get-player.md): Looks up an NBA player by name, including retired players, and returns the bio and regular-season per-game averages for the reported season and career. - [ESPN API: Get team schedule](https://fous.com/methods/espn.com/get-team-schedule.md): Returns a team's past results and upcoming games for a season on ESPN, with opponents, local start times, scores, broadcasts and venues. Soccer fixtures include all competitions shown for the team. - [Premier League API: Get player stats](https://fous.com/methods/premierleague.com/get-player-stats.md): Looks up a Premier League player by name and returns the profile and either career totals or the stats for a chosen season. If names clash, a current Premier League player is preferred. - [NHL API: Get scores](https://fous.com/methods/nhl.com/get-scores.md): Lists NHL games for a date, optionally limited to one team, with start times in the chosen time zone, scores, status, and TV networks. - [All NFL methods](https://fous.com/methods/nfl.com.md)