Sports Data Service API Help

Version: 1.0.0

Endpoints

Schedules

Canonical:
/v1/schedules/{date} - All sports schedules
/v1/schedule/{sport}/{date} - Single sport schedule

Legacy compatibility:
/api/v1/schedules/{date} - JSON compatibility route
/api/v1/schedule/{sport}/{date} - JSON compatibility route
/curl/v1/schedules/{date} - Plain-text compatibility route
/curl/v1/schedule/{sport}/{date} - Plain-text compatibility route

Scores

Canonical:
/v1/scores/{date} - All sports scores
/v1/scores/{sport}/{date} - Single sport scores

Legacy compatibility:
/api/v1/scores/{date} - JSON compatibility route
/api/v1/scores/{sport}/{date} - JSON compatibility route
/curl/v1/scores/{date} - Plain-text compatibility route
/curl/v1/scores/{sport}/{date} - Plain-text compatibility route

Standings

Canonical:
/v1/standings/{sport} - Single sport standings

Legacy compatibility:
/api/v1/standings/{sport} - JSON compatibility route
/curl/v1/standings/{sport} - Plain-text compatibility route

Note: Standings endpoint is currently under development

Season Info

Canonical:
/v1/season-info/{league} - Season phase dates for a league

Legacy compatibility:
/api/v1/season-info/{league} - JSON compatibility route

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

Sports

mlb mls 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 collected from CricAPI, with CricketPuff fallback support.

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 (canonical JSON)
curl -H "Accept: application/json" https://api.sportspuff.net/v1/schedule/nba/today

# Get today's MLB scores (canonical plain text, Eastern Time)
curl -H "Accept: text/plain" "https://api.sportspuff.net/v1/scores/mlb/today?tz=et"

# Get NBA standings (canonical JSON)
curl -H "Accept: application/json" https://api.sportspuff.net/v1/standings/nba

# Get MLB season info
curl https://api.sportspuff.net/v1/season-info/mlb

# Legacy compatibility route example
curl https://api.sportspuff.net/curl/v1/schedule/ipl/today