Sports Data Service API Help

Version: 1.0.0

Endpoints

Schedules

JSON Format:
/api/v1/schedules/{date} - All sports schedules
/api/v1/schedule/{sport}/{date} - Single sport schedule

cURL Format:
/curl/v1/schedules/{date} - All sports schedules
/curl/v1/schedule/{sport}/{date} - Single sport schedule

Scores

JSON Format:
/api/v1/scores/{date} - All sports scores
/api/v1/scores/{sport}/{date} - Single sport scores

cURL Format:
/curl/v1/scores/{date} - All sports scores
/curl/v1/scores/{sport}/{date} - Single sport scores

Standings

JSON Format:
/api/v1/standings/{sport} - Single sport standings

cURL Format:
/curl/v1/standings/{sport} - Single sport standings

Note: Standings endpoint is currently under development

Season Info

JSON Format:
/api/v1/season-info/{league} - Season phase dates for a league

Returns year, current_phase, and season_types with start/end dates. Cached for 24 hours.
Leagues: mlb, nba, nfl, nhl, wnba, ipl, mlc

Sports

mlb nba nfl nhl wnba ipl mlc all

Note: Use all as the sport parameter to get data for all sports combined. IPL and MLC data is provided by CricketPuff.

Date Formats

The {date} parameter accepts:

today - Today's date
tomorrow - Tomorrow's date
yesterday - Yesterday's date
YYYY-MM-DD - ISO format (e.g., 2025-01-15)
YYYYMMDD - Compact format (e.g., 20250115)
M/D/YYYY - US format (e.g., 1/15/2025)
MM/DD/YYYY - US format with leading zeros (e.g., 01/15/2025)

Timezone

Change timezone using the tz query parameter: ?tz=<timezone>

Examples

Parameter	Description
`?tz=et`	Eastern Time
`?tz=pt`	Pacific Time
`?tz=ct`	Central Time
`?tz=mt`	Mountain Time
`?tz=America/New_York`	Full timezone name
`?tz=Europe/London`	International timezone

Supported Aliases

Aliases	Timezone
`et, est, edt, eastern`	US/Eastern
`pt, pst, pdt, pacific`	US/Pacific
`ct, cst, cdt, central`	US/Central
`mt, mst, mdt, mountain`	US/Mountain
`akst, akdt, alaska, ak`	US/Alaska
`hst, hawaii, hi`	US/Hawaii

Default: US/Pacific (Pacific Time)

Help

/api/help or /api/v1/help - JSON formatted help
/curl/help or /curl/v1/help - Plain text help
/help - HTML formatted help (this page)

Examples

# Get today's NBA schedule (JSON)
curl http://localhost:34180/api/v1/schedule/nba/today

# Get today's MLB scores (cURL format, Eastern Time)
curl http://localhost:34180/curl/v1/scores/mlb/today?tz=et

# Get NBA standings (JSON)
curl http://localhost:34180/api/v1/standings/nba

# Get MLB season info
curl http://localhost:34180/api/v1/season-info/mlb

# Get IPL schedule (cricket)
curl http://localhost:34180/curl/v1/schedule/ipl/today