---
title: "SofaScore league draft"
method: GET
path: "/sofascore/draft"
tags: ["SofaScore"]
---

# SofaScore league draft

`GET /sofascore/draft`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/sofascore/draft`
- Auth: API key in header `x-api-key`

Returns the draft attached to a league season: the upcoming or just-held `draft` and the `previous_draft`, each with its year, start and end time, status, the draft `rounds` (the valid `round` values for draft-picks) and whether the lottery is complete. The `league` enum accepts `nba` and `nfl`. Get `season` from tournament-seasons (NBA competition id 132, NFL 9464). A season without a draft, or a season id that does not belong to the league, returns 404. A season whose draft is not scheduled yet returns only `previous_draft`.

## Query parameters

- `league` 'nba' | 'nfl', required
- `season` string, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- SofascoreDraftResponseDoc
  - `code` integer
  - `data` SofascoreDraftResponse
    - `draft` SofascoreDraftInfo
      - `end_time` string
      - `end_timestamp` integer
      - `is_lottery_complete` boolean
      - `rounds` integer[]
      - `start_time` string
      - `start_timestamp` integer
      - `status` string
      - `year` integer
    - `fetched_at` string
    - `has_lottery_draw` boolean
    - `league` string
    - `lottery_year` integer
    - `previous_draft` SofascoreDraftInfo
      - `end_time` string
      - `end_timestamp` integer
      - `is_lottery_complete` boolean
      - `rounds` integer[]
      - `start_time` string
      - `start_timestamp` integer
      - `status` string
      - `year` integer
    - `prospects_year` integer
    - `season` integer
    - `source_url` string
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)