1. NFL
Playbook-API
  • Global
    • Overview
    • Base URL (Servers)
    • Authentication
    • Rate Limits + Usage
    • Errors
    • League / sportKey Conventions
    • Support
  • Core Endpoints
    • Health
      GET
    • Me
      GET
    • Teams
      GET
    • Team Stats
      GET
    • Injuries
      GET
    • Splits
      GET
    • Splits (Historical/History)
      GET
    • Odds-Games
      GET
    • Lines
      GET
    • Games
      GET
    • Recent Form
      GET
    • Head-to-Head
      GET
  • MLB
    • Pitcher Stats (Season)
      GET
    • Starting Pitchers
      GET
    • Ballpark Weather
      GET
    • Strikeout Predictor
      GET
  • NFL
    • Roster
      GET
    • NFL Team Stats
      GET
    • Team vs. Opponent
      GET
    • Player vs. Opponent
      GET
  1. NFL

Roster

GET
https://api.playbook-api.com/v1/nfl/rosters
Last modified:2026-07-17 00:42:45
Returns players from the current promoted roster snapshot for an NFL team.
Current roster only — no historical roster information.
Filter by position, status, or a specific player
Position values:
Offense: QB, RB, FB, WR, TE, OL
Defense: DE, DT, NT, LB, ILB, OLB, CB, DB, S, FS
Special teams: K, P, LS
Example:
https://api.playbook-api.com/v1/nfl/rosters?team=BUF&api_key=YOUR_API_KEY
https://api.playbook-api.com/v1/nfl/rosters?team=BUF&position=QB&api_key=YOUR_API_KEY
https://api.playbook-api.com/v1/nfl/rosters?team=NYG&position=WR&api_key=ceosplitlabs

Request

Query Params

Responses

🟢200Success
application/json
Bodyapplication/json

Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.playbook-api.com/v1/nfl/rosters?team=NFL%20team%20abbreviation%20or%20recognized%20team%20name&position=Position%20filter%20(QB%2C%20RB%2C%20WR%2C%20TE%2C%20OL%2C%20etc.)&status=Case-insensitive%20roster-status%20filter&player_id=Canonical%20Playbook%20player%20ID%20or%20supported%20legacy%20alias'
Response Response Example
{
  "league": "NFL",
  "season": 2026,
  "team": { "id": "BUF", "name": "Buffalo Bills" },
  "filters": { "status": null, "position": "QB", "playerId": null },
  "players": [
    {
      "playerId": "pbk_nfl_qb_josh_allen",
      "name": "Josh Allen",
      "position": "QB",
      "jerseyNumber": "17",
      "status": "Active"
    }
  ],
  "count": 1,
  "meta": {
    "provider": "Playbook API",
    "dataset": "NFL Rosters",
    "definitionVersion": "nfl-rosters-v1",
    "season": 2026,
    "datasetBuiltAt": "2026-07-16T15:25:30.074Z",
    "rosterFetchedAt": "2026-07-16T02:15:03.943Z"
  }
}
Modified at 2026-07-17 00:42:45
Previous
Strikeout Predictor
Next
NFL Team Stats
Built with