API Documentation

Public API endpoints for accessing Fantasy First draft data.

GET/api/drafts/{draftId}

Get Draft Details

Returns complete draft data including configuration, participating teams, all picks, and scores. No authentication required.

Parameters

Name	Type	Description
draftId	integer	The draft ID

Example Response

{
  "draft": {
    "id": 1,
    "draft_name": "Indiana 2025 Draft",
    "league_id": 1,
    "open_time": "2025-01-15T12:00:00.000Z",
    "start_time": "2025-01-15T18:00:00.000Z",
    "close_time": "2025-01-15T22:00:00.000Z",
    "scores_finalized": false,
    "team_list_source": "indiana-2025",
    "round_lengths": [60, 45, 30],
    "round_counts": [1, 1, 1]
  },
  "league": {
    "id": 1,
    "friendly_name": "Test League",
    "short_name": "TST",
    "season": 2025
  },
  "draftTeams": [
    {
      "id": 1,
      "slot": 0,
      "team_short": "A",
      "team": {
        "id": 1,
        "friendly_name": "Team Alpha",
        "players": [
          { "id": 1, "is_team_captain": true, "user": { "name": "John" } }
        ]
      }
    }
  ],
  "draftPicks": [
    {
      "id": 1,
      "pick_id": "4039",
      "assigned_team_id": 1,
      "assigned_team_slot": 0,
      "pick_status": "Picked",
      "score": 125
    }
  ],
  "status": "In Progress"
}

GET/api/leagues/{leagueId}/drafts

List League Drafts

Returns all drafts for a given league with status and team counts. No authentication required.

Parameters

Name	Type	Description
leagueId	integer	The league ID

Example Response

{
  "league": {
    "id": 1,
    "friendly_name": "Test League",
    "short_name": "TST",
    "season": 2025
  },
  "drafts": [
    {
      "id": 1,
      "draft_name": "Indiana 2025 Draft",
      "open_time": "2025-01-15T12:00:00.000Z",
      "start_time": "2025-01-15T18:00:00.000Z",
      "close_time": "2025-01-15T22:00:00.000Z",
      "scores_finalized": false,
      "status": "Closed",
      "teamCount": 8
    }
  ]
}

GET/api/leagues/{leagueId}/picks

List All League Picks

Returns all picks for all drafts in a league, grouped by draft. Includes team information for each pick. No authentication required.

Parameters

Name	Type	Description
leagueId	integer	The league ID

Example Response

{
  "league": {
    "id": 1,
    "friendly_name": "Test League",
    "short_name": "TST",
    "season": 2025
  },
  "drafts": [
    {
      "draft_id": 1,
      "draft_name": "Indiana 2025 Draft",
      "picks": [
        {
          "id": 1,
          "pick_id": "4039",
          "assigned_team_id": 1,
          "assigned_team_slot": 0,
          "pick_status": "Picked",
          "score": 125,
          "team": {
            "id": 1,
            "friendly_name": "Team Alpha",
            "short_name": "ALPHA"
          }
        },
        {
          "id": 2,
          "pick_id": "5460",
          "assigned_team_id": 2,
          "assigned_team_slot": 0,
          "pick_status": "Picked",
          "score": 98,
          "team": {
            "id": 2,
            "friendly_name": "Team Beta",
            "short_name": "BETA"
          }
        }
      ]
    }
  ],
  "totalPicks": 2
}

Draft Status Values

Status	Description
Scheduled	Draft has not opened yet
Open	Draft is open for pick list submissions
In Progress	Draft is actively running
Closed	Draft has ended, scores pending
Finalized	Scores are finalized

Error Responses

Status Code	Description
400	Invalid ID format
404	Draft or league not found
500	Server error

{
  "error": "Draft not found"
}