---
title: "Get player statistics by player id"
method: GET
path: "/american-football/players/{id}/statistics"
tags: ["American Football.Players"]
---

# Get player statistics by player id

`GET /american-football/players/{id}/statistics`

## Request

- Base URL: `https://sports.highlightly.net`
- URL: `https://sports.highlightly.net/american-football/players/{id}/statistics`
- Auth: none declared. Required headers: `x-rapidapi-host`, `x-rapidapi-key`
- TypeScript: <https://skmtc.dev/highlightly/apis/sports-api-highlightly/docs/american-football/players/:id/statistics/get.ts> (a function with typed inputs; its response is checked against the schema)

> Refresh interval: Once a day

Retrieve detailed player statistics for specified `playerId`.

Detailed player statistics are aggregated on a `perSeason` level. Each season has the following available coverage:

| Type               | Description                                                                 |
|--------------------|-----------------------------------------------------------------------------|
| Entire             | Combines both regular season and post-season statistics. Pre-season data is not included. |
| Season             | Includes only regular season statistics.                               |

Recorded stats are dependant on the player position. In total, the following stats are available:

| Type | Description |
|------|--------------|
| General | Overall player or team statistics that summarize performance across multiple aspects (e.g., games played, total yards, touchdowns). |
| Defense | Statistics related to defensive performance, such as tackles, sacks, interceptions, and forced fumbles. |
| Returning| Data for return plays on special teams, including punt returns, kickoff returns, and associated yards or touchdowns. |
| Passing | Passing-related statistics, typically for quarterbacks which inlcude attempts, completions, yards, touchdowns, and interceptions. |
| Rushing | Rushing statistics, measuring ground plays such as attempts, yards gained, and rushing touchdowns. |
| Receiving | Statistics for pass catchers such as receptions, receiving yards, average yards per catch, and receiving touchdowns. |
| Scoring | Scoring-related data, including touchdowns, field goals, extra points, and total points contributed by the player or team. |
| Punting | Information about punting performance such as number of punts, total yards, average distance, and punts inside the 20-yard line. |
| Kicking | Kicking statistics, covering field goals and extra point attempts, makes, and success rates. |

Note: As mentioned earlier, statistics are associated with specific player positions. This means the results you receive will vary depending on the player's position.

![American Football Player stats example](https://highlightly.net/assets/img/documentation/american-football/player-stats.png)

## Path parameters

- `id` number, required

## Headers

- `x-rapidapi-host` string, required
- `x-rapidapi-key` string, required

## Response `200`

- AmericanFootballDetailedPlayerStatisticsResponseDto[]
  - `id` number, required
  - `fullName` string
  - `logo` string
  - `perSeason` AmericanFootballDetailedPlayerStatisticsPerSeasonDto[], required
    - `stats` AmericanFootballStatEntry[], required: Relevant stats for player position.
      - `name` string, required
      - `value` number, required
      - `category` 'General' | 'Defense' | 'Returning' | 'Passing' | 'Rushing' | 'Receiving' | 'Scoring' | 'Punting' | 'Kicking', required
    - `teams` AmericanFootballDetailedPlayerSummaryTeamDto[], required: Teams for which the player played in a given season.
      - `id` number, required
      - `logo` string
      - `name` string, required
      - `league` string, required
      - `displayName` string, required
      - `abbreviation` string, required
    - `league` string, required
    - `season` number, required
    - `seasonBreakdown` 'Entire' | 'Season', required: Represents the coverage for the stored statistics. Pre-season is never included.

## Other responses

- `400`: Bad request descriptive error.
- `500`: Internal server error.

---

[API](https://skmtc.dev/highlightly/apis/sports-api-highlightly.md) - [All operations](https://skmtc.dev/highlightly/apis/sports-api-highlightly/llms.txt) - [OpenAPI document](https://skmtc.dev/highlightly/apis/sports-api-highlightly/revisions/c8a366d3091f?raw)