mcp

List Events

post/v1/mcp/list_events

Request

  • Base URL: https://api.infersports.dev (the document declares no server; this is the origin it was published from)
  • URL: https://api.infersports.dev/v1/mcp/list_events
  • Auth: none declared

Request body

datestring required

Calendar day to list, 'YYYY-MM-DD'. REQUIRED — this tool always returns a bounded window (use list_today_matches for 'today + still-live').

date_tostring nullable

Optional inclusive end day 'YYYY-MM-DD' — one call covers the whole [date, date_to] window (max 31 days), e.g. a tournament's group stage. Omit for a single day.

timezonestring nullable

Optional IANA timezone (e.g. 'Asia/Shanghai', 'America/New_York'). The day boundary is computed in this zone; default is the UTC day. The response keeps UTC scheduled_at as canonical and adds scheduled_at_local per fixture.

sportstring nullable

Filter: football | basketball.

statusstring nullable

Filter: scheduled | live | finished.

leaguestring nullable

Filter by external league id (lg_…).

limitinteger

Max fixtures to return (kickoff order).

Response

Successful Response

datestring required

The calendar day listed (YYYY-MM-DD), in timezone if given else UTC.

date_tostring nullable

Inclusive end day when a range was requested (null = single day).

timezonestring nullable

Echo of the requested timezone (null = UTC day).

countinteger required

Fixtures returned (after the limit cap).

truncatedboolean

True when more fixtures matched the day than were returned.

Changes

No recorded changes to this operation across all 1 revision of this API.