Skip to content
Kelly

Developers

askkelly.aiGet a key

players

Copy page

Read a player's projection, range and status, and compare players side by side.

On this page
MethodPathTitleAccessPriceMCP tool
GET/v1/players/{player_id}Get a playerpublic1get_player

GET /v1/players/{player_id}

Get a playerLink to this section

public, no key needed · 1 credit, not charged during the beta · MCP tool get_player · status live

A player's identity and team, current injury report, latest news and stat lines, each with its source and time. injury is the current report and news the latest items (NFL); each carries its source and time.

ParametersLink to this section

player_idstring · pathrequired

The player's Kelly ID (plr_), from search.

pattern ^plr_[0123456789abcdefghjkmnpqrstvwxyz]{20}$

ResponseLink to this section

200 The player.

objectconstrequired

Always player.

Always "player".

idstringrequired

The player's Kelly ID (plr_).

pattern ^plr_[0123456789abcdefghjkmnpqrstvwxyz]{20}$

namestringrequired

The player's name.

sportstringnullable

The sport's slug, such as american_football.

positionstringnullable

The position, such as WR.

teamone of several shapes

The player's current team, when Kelly knows it.

availabilityarray of object

Each source's latest availability status, by source.

Show 5 fields
statusstring

The status as Kelly stores it (out, doubtful, questionable, ...).

game_idstringnullable

The game it is for, when the source names one.

pattern ^gm_[0123456789abcdefghjkmnpqrstvwxyz]{20}$

seasonstring | integernullable

The season it is for.

weekintegernullable

The week it is for.

provenanceany

Where it came from, and when.

injuryobject

The player's current injury report: the newest designation among the official report and Kelly's injury feeds, with the injury and practice participation from the newest report that names them. Absent when the player is on no current report.

Show 9 fields
statusstring

The designation in words: Out, Doubtful, Questionable, Injured reserve, Physically unable to perform, Suspended, Day-to-day, ...

roster_statusstring

A reserve list the player is on when the designation says something else.

detailstring

The injury in a lower-case word or phrase (hamstring).

practicestring

Practice participation (NFL).

game_daystring

Game-day status when known: active, inactive or out.

seasonstring | integer

The season of the report.

weekinteger

The week of the report (NFL).

reported_atstringnullable

When the source reported it.

format date-time

provenanceany

Where it came from, and when.

newsarray of object

The latest news items, newest first (at most five; NFL).

Show 4 fields
kindstring

injury, transaction or news, as the source files it.

headlinestring

The headline, one plain line of at most 200 characters.

published_atstringnullable

When it was published.

format date-time

provenanceany

Where it came from, and when.

season_linesarray of object

Season stat lines, newest season first.

Show 7 fields
subject_idstring

The player's ID.

pattern ^plr_[0123456789abcdefghjkmnpqrstvwxyz]{20}$

game_idstringnullable

Always null for a season line.

pattern ^gm_[0123456789abcdefghjkmnpqrstvwxyz]{20}$

seasonstringnullable

The season's label.

season_typestringnullable

regular, postseason or preseason.

basisstringnullable

total, per_game or rate.

statsobject

Stat values by Kelly's stat key: an integer, or a decimal as a string of its exact digits. Only stats the register serves on the API appear.

provenanceany

Where it came from, and when.

game_linesarray of object

The latest game's stat lines, by source.

Show 7 fields
subject_idstring

The player's ID.

pattern ^plr_[0123456789abcdefghjkmnpqrstvwxyz]{20}$

game_idstringnullable

The game's ID.

pattern ^gm_[0123456789abcdefghjkmnpqrstvwxyz]{20}$

seasonstringnullable

The season's label.

season_typestringnullable

regular, postseason or preseason.

basisstringnullable

total, per_game or rate.

statsobject

Stat values by Kelly's stat key, as the source gave them: an integer, or a decimal as a string of its exact digits. Only stats the register serves on the API appear.

provenanceany

Where it came from, and when.

provenanceany

Where the player's identity came from.

as_ofstringrequired

When the value was true; for a derived value, its newest input's time.

format date-time

sourcestringrequired

Who produced the value, as shown to readers.

min length 1

stale_after_msintegernullable

On live data: milliseconds it stays current.

min 0

attributionstringnullable

Attribution the source's terms require.

request_idstringnullable

The request that produced this response.

live_topicsarray of string

Kelly Wire topics that update this resource (API and cards only).

rg_linestringnullable

The cost line (COMP-1, D19) on every resource and result that touches wagering: one engine-computed cost fact, or the short form, plus 21+ and the helpline. Show it with the value. Null on resources that don't touch wagering.

ErrorsLink to this section

invalid_request · credential_in_url · unsupported_api_version · unauthenticated · method_not_allowed · rate_limited · internal_error · service_unavailable · quota_exhausted · insufficient_scope · not_entitled · not_found

ExampleLink to this section

Request
GET https://api.askkelly.ai/v1/players/plr_00000000000000000000
Authorization: Bearer $KELLY_API_KEY
Response, 404
{
  "type": "https://docs.askkelly.ai/problems/not_found",
  "title": "Not found",
  "status": 404,
  "code": "not_found",
  "detail": "No player with that player_id is served.",
  "param": "player_id",
  "doc_url": "https://docs.askkelly.ai/problems/not_found",
  "request_id": "req_84476c5588d269dd684553a6",
  "retryable": false,
  "display_message": "That could not be found."
}
Request
GET https://api.askkelly.ai/v1/players/plr_samp1eexamp1eexamp1e
Authorization: Bearer $KELLY_API_KEY
Response, 200
{
  "object": "player",
  "id": "plr_samp1eexamp1eexamp1e",
  "name": "Sample Quarterback",
  "sport": "american_football",
  "position": "QB",
  "team": {
    "id": "tm_mp49sdajkwdncngf5twg",
    "name": "Las Vegas Raiders",
    "abbreviation": "LV",
    "competition": "nfl",
    "provenance": {
      "source": "nflverse",
      "source_ts": "2026-10-04T12:00:00Z",
      "ingest_ts": "2026-10-04T12:00:00Z",
      "known_by": [
        {
          "source": "nflverse",
          "source_id": "LV"
        }
      ]
    }
  },
  "availability": [
    {
      "status": "questionable",
      "game_id": "gm_55zc8ywp3mzwg79py6mv",
      "season": "2026",
      "week": 4,
      "provenance": {
        "source": "nflverse",
        "source_ts": "2026-10-04T17:30:00Z",
        "ingest_ts": "2026-10-04T17:30:00Z"
      }
    }
  ],
  "injury": {
    "status": "Questionable",
    "season": "2026",
    "week": 4,
    "reported_at": "2026-10-04T17:30:00Z",
    "provenance": {
      "source": "nflverse",
      "source_ts": "2026-10-04T17:30:00Z",
      "ingest_ts": "2026-10-04T17:30:00Z"
    }
  },
  "provenance": {
    "source": "nflverse",
    "source_ts": "2026-10-04T17:30:00Z",
    "ingest_ts": "2026-10-04T17:30:00Z",
    "known_by": [
      {
        "source": "nflverse",
        "source_id": "00-0000001"
      }
    ]
  },
  "as_of": "2026-10-04T17:30:00Z",
  "source": "nflverse",
  "attribution": "nflverse data (CC BY 4.0)",
  "request_id": "req_89ed7fb39e05f31337053172",
  "live_topics": [],
  "rg_line": null
}
  1. nflverse · as of 2026-10-04T17:30:00Z · nflverse data (CC BY 4.0)
  2. nflverse · happened at 2026-10-04T12:00:00Z
  3. nflverse · happened at 2026-10-04T17:30:00Z
  4. nflverse · happened at 2026-10-04T17:30:00Z
  5. nflverse · happened at 2026-10-04T17:30:00Z

Generated from Kelly API 2026-10-05.

Support: support@askkelly.ai · Security and disclosure