Sports Data Service API Help
Version: 1.0.0

CANONICAL V1 ROUTES:
  Use /v1/... with Accept: application/json or Accept: text/plain

LEGACY COMPATIBILITY ROUTES:
  /api/v1/... serves JSON compatibility responses
  /curl/v1/... serves plain-text compatibility responses

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

  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.

SPORTS:
  nba, mlb, mls, nfl, nhl, wnba, ipl, mlc, all

  Use 'all' to get data for all sports combined

LEAGUES (for season-info):
  mlb, nba, nfl, nhl, wnba, ipl, mlc

DATE FORMATS:
  today, tomorrow, yesterday
  YYYY-MM-DD (e.g., 2025-01-15)
  YYYYMMDD (e.g., 20250115)
  M/D/YYYY (e.g., 1/15/2025)
  MM/DD/YYYY (e.g., 01/15/2025)

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

  Examples:
    ?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:
    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 (this format)
  /help                         - HTML formatted help

EXAMPLES:
  curl -H "Accept: application/json" https://api.sports-puff.com/v1/schedule/nba/today
  curl -H "Accept: text/plain" "https://api.sports-puff.com/v1/scores/mlb/today?tz=et"
  curl -H "Accept: application/json" https://api.sports-puff.com/v1/standings/nba
  curl https://api.sports-puff.com/v1/season-info/mlb
  curl https://api.sports-puff.com/curl/v1/schedule/ipl/today