Timezones and dates

Times are UTC. The date of a match is the local day of play.

Two kinds of time

start_time is in UTC, written like 2026-03-14T09:40:00Z. date is the local day at the venue, so an evening match in Macao on 14 March is dated 14 March wherever you are.

Filtering

?date=, ?from= and ?to= all use that local day, as YYYY-MM-DD. A range on /v1/matches can span up to 31 days a call.

What your plan can read

Each plan reads a window of days, by that local date. The free key reads yesterday, today and the days ahead; ask outside it and you get 403 upgrade_required. /v1/usage tells you your window.