> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://statpad.dev/docs/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://statpad.dev/docs/_mcp/server. # List current injuries GET https://api.statpad.dev/v1/{league}/injuries Open injuries, each with its latest report. Filled for the NFL; other leagues answer an empty list. Reference: https://statpad.dev/docs/api-reference/league-news/list-injuries ## Authentication - `Authorization` header (bearer token, required) — An API key, sent as `Authorization: Bearer `. ## Request ### Path parameters - `league` (string, required) — The league's alias. ### Query parameters - `team_id` (string, optional) — Only this team's injuries. - `cursor` (string, optional) — `next_cursor` from the previous page. Omit it for the first page. - `limit` (integer, optional, default: 100) — Page size. ### Headers - `If-None-Match` (string, optional) — An `ETag` from an earlier response. When it still matches, the response is 304 with no body. ## Response ### 200 A page of injuries with their players. - `data` (list of Injury, required) - `players` (list of Player, required) - `next_cursor` (string, required, nullable) — Pass as `cursor` for the next page; null on the last page. ## Errors ### 400 Bad Request Error A parameter is missing or invalid (`bad_request`). - `type` (string, required) — Identifies the problem type. - `title` (string, required) - `status` (integer, required) - `code` (enum, required) — `bad_request` a malformed request or message. `unauthorized` a missing or invalid API key. `forbidden` the plan doesn't include the league or feature. `not_found`. `rate_limited`. `resync_required` the requested position is older than the retained history, so subscribe again without `resume` for a fresh snapshot (for a game stream, a REST game read with its `seq` also works). `invalid_resume` a resume seq beyond the stream's head. `slow_consumer` the client fell too far behind and was dropped from a stream, so resume from `resume_from`. `too_many_subscriptions`. `unknown_stream`. `internal`. `unavailable`. `quota_exhausted` the account has used its request allowance for the current period. - Allowed values: `bad_request`, `unauthorized`, `forbidden`, `not_found`, `rate_limited`, `resync_required`, `invalid_resume`, `slow_consumer`, `too_many_subscriptions`, `unknown_stream`, `internal`, `unavailable`, `quota_exhausted` - `detail` (string, optional) - `request_id` (string, optional) - `min_seq` (long, optional) — With `resync_required`, the oldest seq the stream still holds. - `resets_at` (datetime, optional) — With `quota_exhausted`, when the next period's allowance starts. ### 401 Unauthorized Error The API key is missing, unknown or revoked (`unauthorized`). - `type` (string, required) — Identifies the problem type. - `title` (string, required) - `status` (integer, required) - `code` (enum, required) — `bad_request` a malformed request or message. `unauthorized` a missing or invalid API key. `forbidden` the plan doesn't include the league or feature. `not_found`. `rate_limited`. `resync_required` the requested position is older than the retained history, so subscribe again without `resume` for a fresh snapshot (for a game stream, a REST game read with its `seq` also works). `invalid_resume` a resume seq beyond the stream's head. `slow_consumer` the client fell too far behind and was dropped from a stream, so resume from `resume_from`. `too_many_subscriptions`. `unknown_stream`. `internal`. `unavailable`. `quota_exhausted` the account has used its request allowance for the current period. - Allowed values: `bad_request`, `unauthorized`, `forbidden`, `not_found`, `rate_limited`, `resync_required`, `invalid_resume`, `slow_consumer`, `too_many_subscriptions`, `unknown_stream`, `internal`, `unavailable`, `quota_exhausted` - `detail` (string, optional) - `request_id` (string, optional) - `min_seq` (long, optional) — With `resync_required`, the oldest seq the stream still holds. - `resets_at` (datetime, optional) — With `quota_exhausted`, when the next period's allowance starts. ### 403 Forbidden Error The plan doesn't include this league or feature (`forbidden`). - `type` (string, required) — Identifies the problem type. - `title` (string, required) - `status` (integer, required) - `code` (enum, required) — `bad_request` a malformed request or message. `unauthorized` a missing or invalid API key. `forbidden` the plan doesn't include the league or feature. `not_found`. `rate_limited`. `resync_required` the requested position is older than the retained history, so subscribe again without `resume` for a fresh snapshot (for a game stream, a REST game read with its `seq` also works). `invalid_resume` a resume seq beyond the stream's head. `slow_consumer` the client fell too far behind and was dropped from a stream, so resume from `resume_from`. `too_many_subscriptions`. `unknown_stream`. `internal`. `unavailable`. `quota_exhausted` the account has used its request allowance for the current period. - Allowed values: `bad_request`, `unauthorized`, `forbidden`, `not_found`, `rate_limited`, `resync_required`, `invalid_resume`, `slow_consumer`, `too_many_subscriptions`, `unknown_stream`, `internal`, `unavailable`, `quota_exhausted` - `detail` (string, optional) - `request_id` (string, optional) - `min_seq` (long, optional) — With `resync_required`, the oldest seq the stream still holds. - `resets_at` (datetime, optional) — With `quota_exhausted`, when the next period's allowance starts. ### 404 Not Found Error No such league or entity (`not_found`). - `type` (string, required) — Identifies the problem type. - `title` (string, required) - `status` (integer, required) - `code` (enum, required) — `bad_request` a malformed request or message. `unauthorized` a missing or invalid API key. `forbidden` the plan doesn't include the league or feature. `not_found`. `rate_limited`. `resync_required` the requested position is older than the retained history, so subscribe again without `resume` for a fresh snapshot (for a game stream, a REST game read with its `seq` also works). `invalid_resume` a resume seq beyond the stream's head. `slow_consumer` the client fell too far behind and was dropped from a stream, so resume from `resume_from`. `too_many_subscriptions`. `unknown_stream`. `internal`. `unavailable`. `quota_exhausted` the account has used its request allowance for the current period. - Allowed values: `bad_request`, `unauthorized`, `forbidden`, `not_found`, `rate_limited`, `resync_required`, `invalid_resume`, `slow_consumer`, `too_many_subscriptions`, `unknown_stream`, `internal`, `unavailable`, `quota_exhausted` - `detail` (string, optional) - `request_id` (string, optional) - `min_seq` (long, optional) — With `resync_required`, the oldest seq the stream still holds. - `resets_at` (datetime, optional) — With `quota_exhausted`, when the next period's allowance starts. ### 429 Too Many Requests Error The account's request rate (`rate_limited`) or period allowance (`quota_exhausted`, with `resets_at`) is used up. No data is served. - `type` (string, required) — Identifies the problem type. - `title` (string, required) - `status` (integer, required) - `code` (enum, required) — `bad_request` a malformed request or message. `unauthorized` a missing or invalid API key. `forbidden` the plan doesn't include the league or feature. `not_found`. `rate_limited`. `resync_required` the requested position is older than the retained history, so subscribe again without `resume` for a fresh snapshot (for a game stream, a REST game read with its `seq` also works). `invalid_resume` a resume seq beyond the stream's head. `slow_consumer` the client fell too far behind and was dropped from a stream, so resume from `resume_from`. `too_many_subscriptions`. `unknown_stream`. `internal`. `unavailable`. `quota_exhausted` the account has used its request allowance for the current period. - Allowed values: `bad_request`, `unauthorized`, `forbidden`, `not_found`, `rate_limited`, `resync_required`, `invalid_resume`, `slow_consumer`, `too_many_subscriptions`, `unknown_stream`, `internal`, `unavailable`, `quota_exhausted` - `detail` (string, optional) - `request_id` (string, optional) - `min_seq` (long, optional) — With `resync_required`, the oldest seq the stream still holds. - `resets_at` (datetime, optional) — With `quota_exhausted`, when the next period's allowance starts. ### 500 Internal Server Error Something failed on our side (`internal`). Retry with backoff. - `type` (string, required) — Identifies the problem type. - `title` (string, required) - `status` (integer, required) - `code` (enum, required) — `bad_request` a malformed request or message. `unauthorized` a missing or invalid API key. `forbidden` the plan doesn't include the league or feature. `not_found`. `rate_limited`. `resync_required` the requested position is older than the retained history, so subscribe again without `resume` for a fresh snapshot (for a game stream, a REST game read with its `seq` also works). `invalid_resume` a resume seq beyond the stream's head. `slow_consumer` the client fell too far behind and was dropped from a stream, so resume from `resume_from`. `too_many_subscriptions`. `unknown_stream`. `internal`. `unavailable`. `quota_exhausted` the account has used its request allowance for the current period. - Allowed values: `bad_request`, `unauthorized`, `forbidden`, `not_found`, `rate_limited`, `resync_required`, `invalid_resume`, `slow_consumer`, `too_many_subscriptions`, `unknown_stream`, `internal`, `unavailable`, `quota_exhausted` - `detail` (string, optional) - `request_id` (string, optional) - `min_seq` (long, optional) — With `resync_required`, the oldest seq the stream still holds. - `resets_at` (datetime, optional) — With `quota_exhausted`, when the next period's allowance starts. ### 503 Service Unavailable Error Account access or its limits could not be checked because a dependency is unavailable (`unavailable`). No data is served. - `type` (string, required) — Identifies the problem type. - `title` (string, required) - `status` (integer, required) - `code` (enum, required) — `bad_request` a malformed request or message. `unauthorized` a missing or invalid API key. `forbidden` the plan doesn't include the league or feature. `not_found`. `rate_limited`. `resync_required` the requested position is older than the retained history, so subscribe again without `resume` for a fresh snapshot (for a game stream, a REST game read with its `seq` also works). `invalid_resume` a resume seq beyond the stream's head. `slow_consumer` the client fell too far behind and was dropped from a stream, so resume from `resume_from`. `too_many_subscriptions`. `unknown_stream`. `internal`. `unavailable`. `quota_exhausted` the account has used its request allowance for the current period. - Allowed values: `bad_request`, `unauthorized`, `forbidden`, `not_found`, `rate_limited`, `resync_required`, `invalid_resume`, `slow_consumer`, `too_many_subscriptions`, `unknown_stream`, `internal`, `unavailable`, `quota_exhausted` - `detail` (string, optional) - `request_id` (string, optional) - `min_seq` (long, optional) — With `resync_required`, the oldest seq the stream still holds. - `resets_at` (datetime, optional) — With `quota_exhausted`, when the next period's allowance starts. ## Types ### Injury One injury episode with its latest report. Reports are kept as history; this is the current one. - `id` (string, required) - `league` (string, required) — A league's public alias, such as `nfl` or `ncaaf`. - `player_id` (string, required) - `team_id` (string, required, nullable) - `body_part` (string, required, nullable) - `detail` (string, required, nullable) - `side` (enum, required, nullable) - Allowed values: `left`, `right`, `both` - `started_on` (date, required, nullable) - `resolved_on` (date, required, nullable) - `estimated_return` (date, required, nullable) - `status` (enum, required, nullable) — Game designation from the latest report. - Allowed values: `probable`, `questionable`, `doubtful`, `out`, `day_to_day`, `injured_reserve`, `il_7`, `il_10`, `il_15`, `il_60`, `season_ending` - `practice_status` (enum, required, nullable) - Allowed values: `full`, `limited`, `did_not_participate`, `not_listed` - `reported_at` (datetime, required, nullable) - `comment` (string, required, nullable) ### Player A person. One id follows a player across leagues, from college to the pros. - `id` (string, required) - `first_name` (string, required) - `last_name` (string, required) - `full_name` (string, required) - `abbr_name` (string, required, nullable) - `birth_date` (date, required, nullable) - `birth_place` (string, required, nullable) - `height_in` (integer, required, nullable) - `weight_lb` (integer, required, nullable) - `bats` (enum, required, nullable) — Left, right or switch. - Allowed values: `L`, `R`, `S` - `throws` (enum, required, nullable) — Left, right or switch. - Allowed values: `L`, `R`, `S` - `primary_position` (string, required, nullable) - `college` (string, required, nullable) - `rookie_year` (integer, required, nullable) - `draft` (Draft, required, nullable) — What is known of the player's draft. Present when any of its fields is known. - `version` (integer, required) — Bumps on every change to the entity, deletions included. A client holding a version can ignore any state with a lower one. - `updated_at` (datetime, required) ### Draft What is known of the player's draft. Present when any of its fields is known. - `year` (integer, required, nullable) - `round` (integer, required, nullable) - `pick` (integer, required, nullable) - `team_id` (string, required, nullable) ## Examples **Response** ```json { "data": [ { "id": "01a1b986-8e61-7d3f-8b33-5c1d9e7f4a36", "league": "nfl", "player_id": "01a1b986-8e60-7c2d-8f11-3a9b7c5d2e14", "team_id": "01a1b987-6450-7c2a-898a-4dfae5a45300", "body_part": null, "detail": null, "side": null, "started_on": "2026-11-07", "resolved_on": null, "estimated_return": null, "status": "injured_reserve", "practice_status": null, "reported_at": "2026-11-07T17:29:00Z", "comment": null }, { "id": "01a1b986-8e61-7d40-9c44-6d2e0f8a5b47", "league": "nfl", "player_id": "01a1b986-8e60-7c2e-9a22-4b0c8d6e3f25", "team_id": "01a1b987-6450-7c2a-898a-4dfae5a45300", "body_part": "Ankle", "detail": "Sprain", "side": "right", "started_on": "2026-11-05", "resolved_on": null, "estimated_return": "2026-11-16", "status": "questionable", "practice_status": null, "reported_at": "2026-11-06T03:33:00Z", "comment": null } ], "players": [ { "id": "01a1b986-8e60-7c2d-8f11-3a9b7c5d2e14", "first_name": "Lamar", "last_name": "Jackson", "full_name": "Lamar Jackson", "abbr_name": null, "birth_date": null, "birth_place": null, "height_in": null, "weight_lb": null, "bats": null, "throws": null, "primary_position": "QB", "college": null, "rookie_year": null, "draft": null, "version": 1, "updated_at": "2026-11-08T04:59:25.582844Z" }, { "id": "01a1b986-8e60-7c2e-9a22-4b0c8d6e3f25", "first_name": "Kyle", "last_name": "Hamilton", "full_name": "Kyle Hamilton", "abbr_name": null, "birth_date": null, "birth_place": null, "height_in": null, "weight_lb": null, "bats": null, "throws": null, "primary_position": "S", "college": null, "rookie_year": null, "draft": null, "version": 1, "updated_at": "2026-11-08T04:59:25.582844Z" } ], "next_cursor": null } ``` **SDK Code** ```python Baltimore's injury report import requests url = "https://api.statpad.dev/v1/nfl/injuries" headers = {"Authorization": "Bearer "} response = requests.get(url, headers=headers) print(response.json()) ``` ```javascript Baltimore's injury report const url = 'https://api.statpad.dev/v1/nfl/injuries'; const options = {method: 'GET', headers: {Authorization: 'Bearer '}}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Baltimore's injury report package main import ( "fmt" "net/http" "io" ) func main() { url := "https://api.statpad.dev/v1/nfl/injuries" req, _ := http.NewRequest("GET", url, nil) req.Header.Add("Authorization", "Bearer ") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Baltimore's injury report require 'uri' require 'net/http' url = URI("https://api.statpad.dev/v1/nfl/injuries") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["Authorization"] = 'Bearer ' response = http.request(request) puts response.read_body ``` ```java Baltimore's injury report import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("https://api.statpad.dev/v1/nfl/injuries") .header("Authorization", "Bearer ") .asString(); ``` ```php Baltimore's injury report request('GET', 'https://api.statpad.dev/v1/nfl/injuries', [ 'headers' => [ 'Authorization' => 'Bearer ', ], ]); echo $response->getBody(); ``` ```csharp Baltimore's injury report using RestSharp; var client = new RestClient("https://api.statpad.dev/v1/nfl/injuries"); var request = new RestRequest(Method.GET); request.AddHeader("Authorization", "Bearer "); IRestResponse response = client.Execute(request); ``` ```swift Baltimore's injury report import Foundation let headers = ["Authorization": "Bearer "] let request = NSMutableURLRequest(url: NSURL(string: "https://api.statpad.dev/v1/nfl/injuries")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "GET" request.allHTTPHeaderFields = headers let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```