Skip to content

Livematches in play

Demo: Matchboard, opens in a new tab
Docs v2

Leagues

Draft

GET

/v2/leagues/{id}/draft

All plans

View as MarkdownTry in Playground →

One round of a league’s draft (NBA, NFL or any league whose draft our data source tracks): picks in order, each with the selecting club, the club it came from by trade and the player (an id for /v2/players). Each pick also carries the prospect details as the draft records them (position, top-prospect flag, college), and clubs without a pick in that round are listed as well.

prospect.position uses the draft’s own abbreviations (basketball: G, F, C, FC; American football: QB, WR, OT, …). Only traded picks carry tradedFrom — the Clippers, for instance, made the NBA 2026 #5 pick, acquired from the Pacers. player is null if our data source has no profile for the selected player. While a draft is under way, picks appear as they are made. Updated daily.

Parameters

id

pathrequired

league id issued by DataSportsAPI, a positive integer

year

queryrequired

year of the draft, for example 2026

round

query

round number, 1–20; defaults to 1 (the NBA draft has 2 rounds, the NFL’s 7)

Response

meta
year, round, count (number of picks)
errors
400 bad_request — one of: no year given; a year before 1950 or beyond next year; a round not in 1–20403 history_not_in_plan — drafts count as dated to the end of their year, so on the Free, Starter and Pro plans it leaves the history window as soon as the following year begins404 no_data — no draft took place that year, or that round does not exist in it

Any /v2 call can also come back with one of the common errors.

curl -H "Authorization: Bearer sk_live_…" \
    "https://api.datasportsapi.com/v2/leagues/{id}/draft?year=…"
Example
{ "data": { "picks": [
      { "overallPick": 1, "round": 1, "pickInRound": 1,
        "team": { "id": 3510, "name": "Washington Wizards", "code": "WAS", … }, "tradedFrom": null,
        "player": { "id": 9420, "name": "AJ Dybantsa", … },
        "prospect": { "name": "AJ Dybantsa", "position": "F", "topProspect": true,
                      "fromTeam": { "id": 9811, "name": "Brigham Young Cougars", … }, "fromTeamName": "BYU" } },
      { "overallPick": 5, "round": 1, "pickInRound": 5, "team": { "name": "Los Angeles Clippers", … },
        "tradedFrom": { "name": "Indiana Pacers", … }, … }, … ],
    "teamsWithoutPick": [ { "id": 3496, "name": "Denver Nuggets", … }, … ] },
  "meta": { "year": 2026, "round": 1, "count": 30 } }