World Time API

World Time API (timeapi.world) is a free REST API that provides current time, timezone information, UTC offset, DST status, and Unix epoch time for any timezone or IP address. Originally hosted at worldtimeapi.org (now sunset), the service continues as a source-available, drop-in compatible successor built on Cloudflare Workers with p99 latency under 40ms. It supports 537 IANA timezones, IP-to-timezone conversion, and IP geolocation. The API returns JSON or plain-text responses and requires no authentication on the free tier.

World Time API publishes 6 APIs on the APIs.io network, including Geo API, Geo.txt API, Ip API, and 3 more. Tagged areas include Time, Timezone, World Time, UTC, and DST.

The World Time API catalog on APIs.io includes 1 JSON-LD context and 1 Spectral governance ruleset.

World Time API’s developer surface includes documentation, engineering blog, pricing, and 8 more developer resources.

🌐 Visit website 📡 Source on GitHub

37.6/100 thin ▬ flat Agent 32/100 agent aware Full breakdown ↓
scored 2026-08-20 · rubric v0.12.0

AccessFreemiumOpen⚡ Free to try

6 APIs

Time TimezoneWorld TimeUTCDSTDaylight Saving TimeIP GeolocationUnix Epoch

Kin Score

Kin Score How this is scored →
scored 2026-08-20 · rubric v0.12.0

Composite quality — 37.6/100 · thin

Contract Quality 11.8 / 25

Developer Ergonomics 2.4 / 20

Access Clarity 10.0 / 20

Operational Transparency 4.8 / 13

Contract Governance 1.2 / 12

Discoverability 7.4 / 10

Agent readiness — 32/100 · agent aware

Machine-Readable Contract 18 / 18

Agentic Access Contract 10 / 10

Documented Reversibility 6 / 6

MCP Server 0 / 12

Machine-Readable Auth 0 / 10

Idempotency 9 / 9

Stable Error Semantics 0 / 8

Request/Response Examples 7 / 7

Rate-Limit Signaling 7 / 7

Typed Event Surface 0 / 6

Agent Skills 0 / 5

Well-Known Catalog 0 / 4

Consent & Bot Identity 0 / 3

A2A Agent Card 0 / 8

Dry-Run / Simulate Mode 4 / 4

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/worldtimeapi: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 6

Individual APIs this provider publishes, each with its own machine-readable definition.

Rate Limits 1

Documented rate limits and quota policies.

Worldtimeapi Rate Limits

5 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

JSON Schema 2

Standalone JSON Schema definitions for this provider's data models.

DateTimeJsonResponse

15 properties

JSON SCHEMA

GeoJsonResponse

15 properties

JSON SCHEMA

Examples 4

Example request and response payloads for these APIs.

AGENTIC

Resources

Documentation 1

Reference material describing how the API behaves

Documentation

Documentation

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess

AgenticAccess

Build 1

SDKs, sample code, and the tooling you integrate with

GitHubOrg

GitHubOrg

Access & Security 1

Authentication, authorization, and security posture

DomainSecurity

DomainSecurity

Operate 1

Status, limits, changes, and where to get help

RateLimits

RateLimits

Commercial 3

Pricing, plans, and the legal terms of use

Pricing

Pricing

Plans

Plans

FinOps

FinOps

Company 2

The organization behind the API

Website

Website

Blog

Blog

Other 1

Properties that don't map to a standard resource type

Source (apis.yml)

aid: worldtimeapi
name: World Time API
description: World Time API (timeapi.world) is a free REST API that provides current time, timezone information, UTC offset,
  DST status, and Unix epoch time for any timezone or IP address. Originally hosted at worldtimeapi.org (now sunset), the
  service continues as a source-available, drop-in compatible successor built on Cloudflare Workers with p99 latency under
  40ms. It supports 537 IANA timezones, IP-to-timezone conversion, and IP geolocation. The API returns JSON or plain-text
  responses and requires no authentication on the free tier.
type: Index
accessModel:
  pricing: freemium
  onboarding: open
  trial: false
  try_now: true
  public: true
  label: Freemium · Open access
  confidence: medium
  source:
  - plans
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/worldtimeapi.png
url: https://raw.githubusercontent.com/api-evangelist/worldtimeapi/refs/heads/main/apis.yml
created: 2026-06-13
modified: 2026-06-13
specificationVersion: '0.23'
tags:
- Time
- Timezone
- World Time
- UTC
- DST
- Daylight Saving Time
- IP Geolocation
- Unix Epoch
apis:
- aid: worldtimeapi:worldtimeapi-geo-api
  name: World Time API Geo API
  description: The Geo API from World Time API — 3 operation(s) for geo.
  humanURL: https://timeapi.world/
  baseURL: https://timeapi.world/api
  tags:
  - Geo
  properties:
  - type: OpenAPI
    url: openapi/worldtimeapi-geo-api-openapi.yml
  - type: Documentation
    url: https://timeapi.world/
  - type: Pricing
    url: https://timeapi.world/pricing
  - type: FAQ
    url: https://timeapi.world/faq
  - type: GitHubRepository
    url: https://github.com/sleeyax/world-time-api
- aid: worldtimeapi:worldtimeapi-geo-txt-api
  name: World Time API Geo.txt API
  description: The Geo.txt API from World Time API — 1 operation(s) for geo.txt.
  humanURL: https://timeapi.world/
  baseURL: https://timeapi.world/api
  tags:
  - Geo.txt
  properties:
  - type: OpenAPI
    url: openapi/worldtimeapi-geo-txt-api-openapi.yml
  - type: Documentation
    url: https://timeapi.world/
  - type: Pricing
    url: https://timeapi.world/pricing
  - type: FAQ
    url: https://timeapi.world/faq
  - type: GitHubRepository
    url: https://github.com/sleeyax/world-time-api
- aid: worldtimeapi:worldtimeapi-ip-api
  name: World Time API Ip API
  description: The Ip API from World Time API — 3 operation(s) for ip.
  humanURL: https://timeapi.world/
  baseURL: https://timeapi.world/api
  tags:
  - IP
  tags_raw:
  - Ip
  properties:
  - type: OpenAPI
    url: openapi/worldtimeapi-ip-api-openapi.yml
  - type: Documentation
    url: https://timeapi.world/
  - type: Pricing
    url: https://timeapi.world/pricing
  - type: FAQ
    url: https://timeapi.world/faq
  - type: GitHubRepository
    url: https://github.com/sleeyax/world-time-api
- aid: worldtimeapi:worldtimeapi-ip-txt-api
  name: World Time API Ip.txt API
  description: The Ip.txt API from World Time API — 1 operation(s) for ip.txt.
  humanURL: https://timeapi.world/
  baseURL: https://timeapi.world/api
  tags:
  - Ip.txt
  properties:
  - type: OpenAPI
    url: openapi/worldtimeapi-ip-txt-api-openapi.yml
  - type: Documentation
    url: https://timeapi.world/
  - type: Pricing
    url: https://timeapi.world/pricing
  - type: FAQ
    url: https://timeapi.world/faq
  - type: GitHubRepository
    url: https://github.com/sleeyax/world-time-api
- aid: worldtimeapi:worldtimeapi-timezone-api
  name: World Time API Timezone API
  description: The Timezone API from World Time API — 7 operation(s) for timezone.
  humanURL: https://timeapi.world/
  baseURL: https://timeapi.world/api
  tags:
  - Timezone
  properties:
  - type: OpenAPI
    url: openapi/worldtimeapi-timezone-api-openapi.yml
  - type: Documentation
    url: https://timeapi.world/
  - type: Pricing
    url: https://timeapi.world/pricing
  - type: FAQ
    url: https://timeapi.world/faq
  - type: GitHubRepository
    url: https://github.com/sleeyax/world-time-api
- aid: worldtimeapi:worldtimeapi-timezone-txt-api
  name: World Time API Timezone.txt API
  description: The Timezone.txt API from World Time API — 1 operation(s) for timezone.txt.
  humanURL: https://timeapi.world/
  baseURL: https://timeapi.world/api
  tags:
  - Timezone.txt
  properties:
  - type: OpenAPI
    url: openapi/worldtimeapi-timezone-txt-api-openapi.yml
  - type: Documentation
    url: https://timeapi.world/
  - type: Pricing
    url: https://timeapi.world/pricing
  - type: FAQ
    url: https://timeapi.world/faq
  - type: GitHubRepository
    url: https://github.com/sleeyax/world-time-api
common:
- type: AgenticAccess
  url: agentic-access/worldtimeapi-agentic-access.yml
- type: DomainSecurity
  url: security/worldtimeapi-domain-security.yml
- type: Website
  url: https://timeapi.world/
- type: Documentation
  url: https://timeapi.world/
- type: GitHubOrg
  url: https://github.com/sleeyax/world-time-api
- type: Blog
  url: https://dev.to/sleeyax/i-built-a-better-world-time-api-14mh
- type: Pricing
  url: https://timeapi.world/pricing
- type: X
  url: https://x.com/sleeyax
- type: Plans
  url: plans/worldtimeapi-plans-pricing.yml
- type: RateLimits
  url: rate-limits/worldtimeapi-rate-limits.yml
- type: FinOps
  url: finops/worldtimeapi-finops.yml
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com