Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

World Time API Timezone API

The Timezone API from World Time API — 7 operation(s) for timezone.

World Time API Timezone API is one of 6 APIs that World Time API publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Timezone. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, pricing, and a GitHub repository.

This API exposes 7 operations across 7 paths, and defines 6 schemas. It is described by OpenAPI 3.0.1, at version 2025-10-01.

Requests are made against a single base URL, https://public.timeapi.world/api/.

7 operations 7 paths 6 schemas 7 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.1
API Version
2025-10-01
Base URL
https://timeapi.world/api
Resource Areas
1

Paths & Operations 7

Across 7 paths, the API surfaces 7 operations — 7 GET. Each is listed below with its method, path, parameters, and response codes.

Timezone 7
GET
/timezone
a listing of all timezones.
→ default
GET
/timezone/{area}
a listing of all timezones available for that area.
1 param → 200default
GET
/timezone/{area}.txt
a listing of all timezones available for that area.
1 param → 200default
GET
/timezone/{area}/{location}
request the current time for a timezone.
2 params → 200default
GET
/timezone/{area}/{location}.txt
request the current time for a timezone.
2 params → 200default
GET
/timezone/{area}/{location}/{region}
request the current time for a timezone.
3 params → 200default
GET
/timezone/{area}/{location}/{region}.txt
request the current time for a timezone.
3 params → 200default

Schemas 6

The contract defines 6 schemas that model the data the API accepts and returns. The most detailed are DateTimeJsonResponse (15 properties), ErrorJsonResponse (1 property). Each schema is shown below with its type and property counts.

ListTextResponse
string
a list of available timezones, one per line
ErrorTextResponse
string
details about the error encountered in plain text
DateTimeJsonResponse
object
15 properties 12 required
ErrorJsonResponse
object
1 property 1 required
ListJsonResponse
array
a list of available timezones
DateTimeTextResponse
string
time zone details, as per the DateTimeJsonResponse response, in the format key: value, one item per line

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

worldtimeapi-timezone-api-openapi.yml Raw ↑

Other APIs World Time API publishes across the network.

World Time API Geo API
World Time API Geo.txt API
World Time API Ip API
World Time API Ip.txt API
World Time API Timezone.txt API