Developer API · v1

Build on top of
UnderDraft

A RESTful API that gives you full programmatic access to leagues, teams, players, schedules, scores, and stats. Integrate UnderDraft data into your own apps, dashboards, or workflows.

Base URLhttps://api.underdraft.app/v1
50+Endpoints
<100msAvg. latency
99.9%Uptime SLA
RESTJSON · Bearer auth

Everything you need

One consistent API surface for all UnderDraft data.

League & Season data

Read and manage leagues, divisions, seasons, standings, and playoff brackets.

Team & Roster management

Add or remove players, update rosters, and manage captain assignments programmatically.

Schedule & Games

Fetch upcoming and past games, venues, and referee assignments. Create and reschedule games.

Live scores & stats

Submit score updates mid-game and pull real-time stat lines per player and per team.

Webhooks

Subscribe to game events, score changes, and roster updates delivered to your endpoint.

Authentication & keys

Scoped API keys with read-only or read-write permissions. Rotate or revoke from your dashboard.

Core endpoints

All endpoints return JSON and are secured with Bearer token auth.

GET/leagues

List all leagues for your organization

GET/leagues/{id}/standings

Current division standings

GET/games

List games with optional date and status filters

GET/games/{id}

Single game detail with live stats

PATCH/games/{id}/score

Update home and away score

GET/teams/{id}/roster

Full player roster for a team

POST/teams/{id}/players

Add a player to a team

GET/players/{id}/stats

Career and season stats for a player

Quick start

Up and running in minutes

Authenticate with your API key and start pulling live league data with a single request. Full SDK support is coming soon.

  • 1Create a free UnderDraft account and register as an Organizer.
  • 2Generate an API key from your organization dashboard.
  • 3Authenticate requests using the Authorization: Bearer header.
  • 4Call any endpoint — responses are standard JSON with consistent pagination.
example.sh
# 1 — Fetch all leagues for your organization
curl https://api.underdraft.app/v1/leagues \
  -H "Authorization: Bearer YOUR_API_KEY"

# 2 — Get a single game with live stats
curl https://api.underdraft.app/v1/games/{game_id} \
  -H "Authorization: Bearer YOUR_API_KEY"

# 3 — Submit a score update
curl -X PATCH https://api.underdraft.app/v1/games/{game_id}/score \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"home": 3, "away": 1}'

Start building today

Create a free UnderDraft account to get your API key and access the full developer documentation.