# GET /v2/leagues/{id}/draft

Group: Leagues

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.

Plans: Every plan, Free included.

Note: 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

| Name | In | Required | Description |
| --- | --- | --- | --- |
| `id` | path | yes | league id issued by DataSportsAPI, a positive integer |
| `year` | query | yes | year of the draft, for example 2026 |
| `round` | query | no | round number, 1–20; defaults to 1 (the NBA draft has 2 rounds, the NFL’s 7) |

## Response

- `data`: `DraftRound`
- `meta`: year, round, count (number of picks)
- Objects: DraftRound (https://datasportsapi.com/markdown/reference.md#draftround)

## Errors

- 400 bad_request — one of: no year given; a year before 1950 or beyond next year; a round not in 1–20
- 403 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 begins
- 404 no_data — no draft took place that year, or that round does not exist in it

Plus the common errors (https://datasportsapi.com/markdown/docs.md#errors).

## Request

cURL:

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

TypeScript:

```ts
const { data, meta } = await client.leagues.draft(id, { year });
```

Python:

```python
res = client.leagues.draft(id, year=year)
```

Go:

```go
res, err := client.Leagues.Draft(ctx, id, &datasportsapi.LeaguesDraftParams{Year: year})
```

CLI:

```bash
$ dsa leagues draft <id> --year <year>
```

## Example response

```json
{ "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 } }
```

---

Base URL: https://api.datasportsapi.com. Authenticate each /v2 call with the header `Authorization: Bearer <key>` (secret keys begin with `sk_live_`).
HTML: https://datasportsapi.com/docs/leagues/draft/ · All docs: https://datasportsapi.com/markdown/docs.md · Data reference: https://datasportsapi.com/markdown/reference.md
