Timezones & Dates - AnySport

To avoid cross-timezone ambiguity, all time fields in AnySport use UTC, whether in query parameters or response fields. Clients are responsible for converting to the end user’s local timezone before display — the API itself performs no timezone inference or conversion.

Field	Format	Example	Description
Parameter `date` / `from` / `to`	`YYYY-MM-DD`	`2026-07-15`	For queries, UTC date
Response field `date` (fixtures/head-to-head)	`YYYY-MM-DD`	`2026-07-15`	Same as input (ISO)
Response field `time` (fixtures/head-to-head)	`HH:mm`	`19:00`	Kickoff time, UTC
`updated_at` (live data feeds)	ISO-8601 with `Z`	`2026-07-12T20:52:03Z`	UTC instant
`meta.timestamp`	ISO-8601 with `Z`	`2026-07-13T15:50:00Z`	Server-side UTC instant

Two time representations

You’ll notice the API uses two different levels of time granularity:

Separate date + time (date + time): used for fixture-related fields, where date is YYYY-MM-DD and time is HH:mm, both in UTC. When you need to combine them, concatenate them yourself, e.g. 2026-07-15T19:00:00Z.
A single ISO-8601 instant (with a Z suffix): used for updated_at in live feeds and meta.timestamp in the response envelope — already a complete datetime string that can be passed directly to most languages’ date-parsing functions.

Localized display example

The following examples show how to convert the UTC time returned by the API into the user’s local time:

// The matches endpoint returns date="2026-07-15", time="19:00" (both UTC)
const utcDateTime = new Date(`2026-07-15T19:00:00Z`);
const localString = utcDateTime.toLocaleString(undefined, {
  timeZone: Intl.DateTimeFormat().resolvedOptions().timeZone,
});
console.log(localString); // Displayed in the browser's local timezone

from datetime import datetime, timezone
from zoneinfo import ZoneInfo

# The matches endpoint returns date="2026-07-15", time="19:00" (both UTC)
utc_dt = datetime.fromisoformat("2026-07-15T19:00:00").replace(tzinfo=timezone.utc)
local_dt = utc_dt.astimezone(ZoneInfo("Asia/Shanghai"))
print(local_dt.strftime("%Y-%m-%d %H:%M %Z"))

Both request and response dates use ISO YYYY-MM-DD; time and date are both UTC — to display local time, the client must convert according to the user’s timezone. This convention applies to every endpoint in this documentation and is not repeated on each individual endpoint page.