Find the right NFLMeta page before you guess the path.

Compare free, starter, pro, and business plans, monthly quotas, and who each tier is for.

Platform trust posture, data ownership model, operational controls, and support commitments.

Common answers about access, identifiers, endpoint choice, coverage, and integration flow.

Fastest path from account creation to the first successful request in curl, JavaScript, and Python.

Platform health, recent incidents, uptime posture, and operational change visibility.

Public release notes for docs, auth, search, customer flows, and product-level changes.

API-facing contract changes, docs-surface updates, and integration-relevant improvements.

What the API is, who it is for, and where to start.

First successful request, auth header, and core model.

Headers, limits, quota signals, and failure responses.

How to discover keys and ids before item routes.

Official TypeScript/JavaScript and Python SDKs, package names, usage patterns, and escape hatches.

Search pages, endpoints, recipes, and identifier patterns.

Curated, app-facing endpoint families.

Raw and historical surfaces for ETL and research.

Common tasks with copy-paste examples.

Recent platform and contract changes that matter.

Best first request if you want to confirm auth, inspect shape, and understand the slice-and-field model.

Best first drilldown request when you want the smallest stable payload possible.

Best first app-style payload if your integration is schedule, recaps, matchups, or game detail heavy.

Best first raw export request if you are evaluating warehouse or ETL-style access.

Use the teams list first when you do not already know the canonical NFL abbreviation used by team routes.

Use the games index first, then take the returned id into the single-game routes.

Use the player catalog/list endpoint first, then copy the canonical player_key from the matching row.

Use the coach list endpoint first if you do not already know the canonical coach_key slug.

Use the contributor list endpoint first when you know the contributor name but not the canonical contributor_key.

Use the staff list endpoint first when you know the current coach or staffer name but not the canonical staff_key.

Use the executive list endpoint first when you know the executive name or team text but not the canonical executive_key.

Use the Hall of Fame list first when you want to inspect ballot coverage, then switch to one election-year route.

Use the raw venue reference list first when you need a canonical venue_key for one stadium or historical venue record.

Use the raw officials reference list first when you want the canonical official_key for one referee or crew member.

Start from the Super Bowl or playoff summary routes, then take the returned playoff game id into postseason detail routes.

Season routes use the canonical year directly, so discover it from the season catalog if you are browsing available coverage.

Use the coach page route when you want the main coach object for a single person.

Use the contributor route when the person lives in NFLMeta as a Hall of Fame contributor rather than a player, coach, or executive.

Use the staff route when you want the current assistant, coordinator, or support-staff profile for one person.

Use the executive career slice when you need tenure and role context without the full profile payload.

Use a field drilldown when you need a single value like weather, stadium, or kickoff.

Use a focused team slice or a team field drilldown instead of loading the full team payload.

Season drilldowns are the easiest way to fetch one season-level result like champion, winner, or summary fields.

Use reference endpoints when you want a row that stays close to the underlying table shape.

Use the TypeScript SDK when your app already runs in Node or modern JavaScript and you want typed resource clients instead of hand-built fetch calls.

Use the Python SDK for scripts, notebooks, internal tools, and research workflows that want a thin synchronous client with the same resource model.

Keep using the SDK even when a new route ships before a dedicated wrapper method. The low-level get method preserves auth, rate-limit parsing, and the standard response envelope.

Direct asset discovery for logos or image catalogs.

Direct asset discovery for logos or image catalogs.

Returns a structured coach resource with identity, bio, career, and history slices.

Returns birth, college, playing-background, and narrative bio fields for one coach.

Returns a single field from the coach bio slice. Supported fields include birth_date, birth_place, death_date, death_place, college_name, playing_position, bio_summary, did_you_know, playing_career_summary, playing_college_years, pro_football_hall_of_fame_year, playing_nfl_years, playing_nfl_teams, and played_in_nfl.

Returns aggregate coaching results and title metrics for one coach.

Returns a single field from the coach career slice. Supported fields include first_year, last_year, years_total, regular_games, regular_wins, regular_losses, regular_ties, regular_win_pct, playoff_years, playoff_games, playoff_wins, playoff_losses, playoff_win_pct, championships, super_bowls, conference_titles, average_rank, and best_rank.

Returns team history, award summaries, team-record stints, and stadium summaries for one coach.

Returns name, photo, Hall of Fame, and rank fields for one coach.

Returns a single field from the coach identity slice. Supported fields include coach_key, display_name, source_name, photo_path, hall_of_fame, and rank.

Returns contributor-only Hall of Fame people not currently represented as players, coaches, or executives.

Returns a structured contributor resource with identity, bio, and Hall of Fame history slices.

General bio lookups and app-facing reads.

General bio lookups and app-facing reads.

General history lookups and app-facing reads.

Historical reference browsing for logos, officials, stadiums, or venues.

General identity lookups and app-facing reads.

General identity lookups and app-facing reads.

Returns executive reference rows with optional search, team-text, and Hall of Fame filters.

Returns a structured executive resource with identity, bio, career, and history slices.

General bio lookups and app-facing reads.

General bio lookups and app-facing reads.

General career lookups and app-facing reads.

General career lookups and app-facing reads.

General history lookups and app-facing reads.

Historical reference browsing for logos, officials, stadiums, or venues.

General identity lookups and app-facing reads.

General identity lookups and app-facing reads.

Browse regular-season and playoff games with simple season, week, team, and date filters. Start here when you need to discover a game id before calling a detail endpoint.

Single-game detail pages, matchup views, and field-level game reads.

Returns a single top-level field from the regular game detail payload. Supported fields include id, season_year, week, round, game_date, kickoff_at, title, away_team, home_team, away_coach, home_coach, away_score, home_score, stadium, broadcast_network, announcers, summary, and is_playoff.

Rich game detail pages that need joined metadata without chaining many requests.

Returns Hall of Fame nominee rows across election years with optional year, role, ballot, and inductee filters.

Returns the grouped nominee ballot for one election year.

Returns a single field from the Hall of Fame election-year payload. Supported fields include election_year, total_nominees, inductee_count, and groups.

Historical reference browsing for logos, officials, stadiums, or venues.

Historical reference browsing for logos, officials, stadiums, or venues.

General coaches lookups and app-facing reads.

Lightweight product capability checks and public demo surfaces.

General health lookups and app-facing reads.

Returns a smaller bio-focused player payload with birth, size, college, and draft fields.

Returns a single field from the player bio slice.

Returns the persisted normalized career totals row for one player from `player_career_stats`, including core totals plus expanded snap, advanced, explosive-play, and specialist fields when present.

Returns a single field from the player career totals payload.

Returns persisted normalized season rows from `player_career_stat_seasons` for one player, including core stat totals plus expanded snap, advanced, explosive-play, and specialist columns.

Returns game-by-game stat lines for one player. Use season and week filters for granular lookups like a quarterback's passing yards, touchdowns, and interceptions in a specific week.

Returns only player honors data, split into Pro Bowls, All-Pro selections, awards, and Hall of Fame status.

Returns a single field from the player honors slice.

Returns a smaller identity-focused player payload with name, team, position, status, and hero-card fields.

Returns a single field from the player identity slice. Supported fields include player_key, display_name, football_name, first_name, last_name, position_group, position, latest_team_abbr, jersey_number, rookie_season, last_season, status, years_of_experience, and headshot_url.

Returns canonical external ids for a single player.

Returns a single field from the player ids slice.

Returns season-level kicking rows from `player_kicker_season_stats` for one player. Use the season and field drilldowns when the client only needs one season or one stat.

Returns one season-level kicking row for a player.

Returns one top-level field from a player's season-level kicking row.

Returns season-level punting rows from `player_punter_season_stats` for one player. Use the season and field drilldowns when the client only needs one season or one stat.

Returns one season-level punting row for a player.

Returns one top-level field from a player's season-level punting row.

Returns career total, best season, and best game snapshots for a configurable list of stats.

Returns a single top-level field from the player records payload.

Returns only roster-history rows for one player.

Returns aggregated game-log totals for one player with split buckets for season type, team, opponent, home/away, and result.

Returns a single top-level field from the player splits payload.

Single playoff game pages and postseason game detail fetches.

Returns a single top-level field from the playoff game detail payload. Supported fields include id, season_year, week, round, game_date, kickoff_at, title, away_team, home_team, away_coach, home_coach, away_score, home_score, stadium, broadcast_network, announcers, summary, and is_playoff.

Postseason matchup pages that need game context plus related joins.

Playoff picture and postseason qualification snapshots.

Returns the table-shaped raw coach row for one coach key, including source columns and parsed raw_row data when present.

Returns a single field from the raw coach record.

Returns the table-shaped raw official row for one official key, including parsed raw_row data when present.

Returns a single field from the raw official record.

Returns the table-shaped raw venue row for one venue key, including parsed raw_row data when present.

Returns a single field from the raw venue record.

General byes lookups and app-facing reads.

Season summary reads and one-field season outcomes.

Returns a single field from the main season summary payload. Supported fields include season_year, super_bowl, winner, runner_up, final_score, mvp, and summary.

Season catalogs and year browsing.

Returns current staff rows from the active team staff dataset with search, team, role-group, title, and linked-coach filters.

Returns a structured current staff resource with identity, bio, career, and source-history slices.

General bio lookups and app-facing reads.

General bio lookups and app-facing reads.

General career lookups and app-facing reads.

General career lookups and app-facing reads.

General history lookups and app-facing reads.

Historical reference browsing for logos, officials, stadiums, or venues.

General identity lookups and app-facing reads.

General identity lookups and app-facing reads.

Standings tables and week-to-week ranking views.

Returns player career total rows across the whole database, ranked by the requested stat column. Supports raw totals plus normalized snap, advanced, explosive-play, and specialist fields. Position filters use season-derived historical career metadata from `player_career_stats`. Use `/api/v1/stats/players/catalog` for the live stat allowlist.

Path-based shortcut for cross-player career leaderboards. Equivalent to `/api/v1/stats/players/careers?stat=...` with the stat encoded in the route.

Returns the live supported stat columns and filter names for the player season and career stats query endpoints. Use this instead of hardcoding stat allowlists.

Returns profile, career totals, season rows, and optional game-log aggregate totals for a set of players.

Returns player game rows across the database, ranked by the requested game stat column. Supports `season_type=REG|POST|ALL` plus team, opponent, home/away, result, and week-range split filters. Regular-season rows use PFR boxscore data; postseason rows use the structured playoff stat tables.

Family-specific wrapper around the player game leaderboard endpoint with a sensible default stat for each family.

Builds grouped split summaries from the cross-player player game stat query, including top leaders in each bucket.

Player search endpoint with attached career coverage and season-row availability metadata.

Groups cross-player game leaderboard output into weekly or playoff-round buckets and ranks leaders inside each bucket.

Returns player season rows across the whole database, filtered by season and ranked by the requested stat column. Supports raw totals plus normalized snap, advanced, explosive-play, and specialist fields. Season team and season position fields reflect the historical season row, not the player's current profile. Use `/api/v1/stats/players/catalog` for the live stat allowlist.

Path-based shortcut for cross-player season leaderboards. Equivalent to `/api/v1/stats/players/seasons?season_year=...&stat=...` with both values encoded in the route.

Aggregates player season stat rows by player and team abbreviation so traded-player output can be analyzed by stint.

Super Bowl histories, franchise appearances, and championship summaries.

Super Bowl histories, franchise appearances, and championship summaries.

Single-team detail views and lightweight team drilldowns.

General teams lookups and app-facing reads.

Single-team detail views and lightweight team drilldowns.

Team schedule, recent games, and franchise-specific game browsing.

Returns a smaller team identity payload with canonical team fields and available season years.

Returns a single field from the team identity slice. Supported fields include id, abbr, city, nickname, fullName, conference, division, gameCount, and seasonYears.

Returns only power ranking rows for one team season.

Returns a single field from the team power rankings slice.

Returns only the resolved Pro Bowl roster for one team season.

Returns a single field from the team Pro Bowl slice.

Broader team detail pages that need an app-ready combined object.

Returns a single top-level field from the full team profile payload.

Returns only the season-specific profile fields for one team, without extras.

Returns a single field from the team season slice.

Returns only the resolved stadium payload for one team season.

Returns a single field from the team stadium slice.

Returns only the offense, defense, and special teams stat groups for one team season.

Returns a single field from the team stats slice.

Programmatic quota and usage checks from client dashboards or internal tooling.