Skip to content
datasportsAPI

LeaguesDraft

Documentation

/

Type to filter the docs by title or path.

LeaguesEndpoint 77 of 116

Draft

GET

/v2/leagues/{id}/draft

Plan
All plans
Auth
Bearer dsa_live_…
Parameters
2 required · 1 optional
Returns
DraftRound
Try in Playground

Returns a single round of a league’s draft — the NBA, the NFL and any other league whose draft our data source tracks.

Picks come in order, each with the selecting club, the club it was acquired from in a trade, the player (an id for /v2/players) and the prospect details as the draft records them (position, top-prospect flag, college). Clubs without a pick in that round are listed as well.

Worth knowing

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.

01Parameters

  • idpathRequired

    league id issued by DataSportsAPI, a positive integer

  • yearqueryRequired

    year of the draft, for example 2026

  • roundqueryOptional

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

02Request

The same call from the command line and each SDK. The SDK lines assume a client created with your key; left out, it is read from DATASPORTSAPI_API_KEY. Installing a client: SDKs & CLI.

curl -H "Authorization: Bearer dsa_live_…" \
    "https://api.datasportsapi.com/v2/leagues/{id}/draft?year=…"

03Response

The top-level keys of the JSON body. Each object links to its full shape in the data reference.

data
DraftRound
meta
year, round, count (number of picks)
ObjectsDraftRound
Example response
{ "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 } }

04Errors

  • 400bad_request

    one of: no year given; a year before 1950 or beyond next year; a round not in 1–20

  • 403history_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 begins

  • 404no_data

    no draft took place that year, or that round does not exist in it

Any key can also meet401unauthorized429rate_limited429quota_exceeded500internal_errorEvery error code