TimezoneDB website screenshot

TimezoneDB

TimezoneDB is a REST API providing timezone information for cities and coordinates worldwide. It supports looking up local time, GMT offset, and daylight saving time (DST) status by timezone name, geographic coordinates (latitude/longitude), city name, or IP address. The service also supports converting times between timezones and listing all 400+ supported timezones across 240+ countries. Responses are available in JSON or XML formats.

TimezoneDB publishes 2 APIs on the APIs.io network: Conversion API and Timezones API. Tagged areas include Timezone, Time, Geographic Coordinates, DST, and UTC Offset.

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

TimezoneDB’s developer surface includes authentication, documentation, pricing, and 8 more developer resources.

🌐 Visit website 📡 Source on GitHub
50.1/100 developing ▬ flat Agent 44/100 agent ready Full breakdown ↓
scored 2026-08-05 · rubric v0.9.1
AccessFreemiumSelf serve⚡ Free to try
2 APIs
TimezoneTimeGeographic CoordinatesDSTUTC OffsetTime ConversionLocation

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-08-05 · rubric v0.9.1
Composite quality — 50.1/100 · developing
Contract Quality 19.6 / 25
Developer Ergonomics 3.9 / 20
Commercial Clarity 10.0 / 20
Operational Transparency 2.7 / 13
Governance 7.0 / 12
Discoverability 6.9 / 10
Agent readiness — 44/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 8 / 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 0 / 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/timezonedb: 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 2

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

TimezoneDB Conversion API

Operations for converting time between timezones

TimezoneDB Timezones API

Operations for listing and retrieving timezone information

Pricing Plans 1

Published pricing tiers and plan structures.

Timezonedb Plans Pricing

3 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Timezonedb Rate Limits

2 limits

RATE LIMITS

FinOps 1

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

Timezonedb Finops

FINOPS

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Timezonedb Context

4 classes · 25 properties

JSON-LD

Spectral Rules 1

Spectral governance rulesets for linting and validating these APIs.

TimezoneDB API Rules

5 rules · 3 warnings 2 info

SPECTRAL

JSON Schema 3

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

ConvertTimeZoneResponse

9 properties

JSON SCHEMA

GetTimeZoneResponse

17 properties

JSON SCHEMA

ListTimeZoneResponse

3 properties

JSON SCHEMA

Examples 3

Example request and response payloads for these APIs.

Convert Time Zone

3 fields

EXAMPLE

Get Time Zone

4 fields

EXAMPLE

List Time Zone

3 fields

EXAMPLE

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Timezonedb Authentication

apiKey · 1 scheme

SECURITY

Timezonedb Domain Security

TLSv1.3 · HSTS · DNSSEC · DMARC

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Timezonedb Agentic Access

3 operations

3 operations · 0 acting

AGENTIC

Resources

Get Started 1

Portal, sign-up, and the first successful call

Register
Register

Documentation 1

Reference material describing how the API behaves

Documentation
Documentation

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess
AgenticAccess

Access & Security 2

Authentication, authorization, and security posture

DomainSecurity
DomainSecurity
 Authentication
Authentication

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 1

The organization behind the API

Website
Website

Other 1

Properties that don't map to a standard resource type

X
X

Source (apis.yml)

apis.yml Raw ↑ 
aid: timezonedb
name: TimezoneDB
description: TimezoneDB is a REST API providing timezone information for cities and coordinates worldwide. It supports looking
  up local time, GMT offset, and daylight saving time (DST) status by timezone name, geographic coordinates (latitude/longitude),
  city name, or IP address. The service also supports converting times between timezones and listing all 400+ supported timezones
  across 240+ countries. Responses are available in JSON or XML formats.
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Freemium · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/timezonedb.png
url: https://raw.githubusercontent.com/api-evangelist/timezonedb/refs/heads/main/apis.yml
created: '2026-06-13'
modified: '2026-06-13'
specificationVersion: '0.19'
tags:
- Timezone
- Time
- Geographic Coordinates
- DST
- UTC Offset
- Time Conversion
- Location
apis:
- aid: timezonedb:timezonedb-conversion-api
  name: TimezoneDB Conversion API
  description: Operations for converting time between timezones
  humanURL: https://timezonedb.com/api
  baseURL: https://api.timezonedb.com/v2.1
  tags:
  - Conversion
  properties:
  - type: OpenAPI
    url: openapi/timezonedb-conversion-api-openapi.yml
  - type: Documentation
    url: https://timezonedb.com/api
  - type: JSONSchema
    url: https://raw.githubusercontent.com/api-evangelist/timezonedb/refs/heads/main/json-schema/list-time-zone-response.json
  - type: JSONSchema
    url: https://raw.githubusercontent.com/api-evangelist/timezonedb/refs/heads/main/json-schema/get-time-zone-response.json
  - type: JSONSchema
    url: https://raw.githubusercontent.com/api-evangelist/timezonedb/refs/heads/main/json-schema/convert-time-zone-response.json
  - type: Examples
    url: https://raw.githubusercontent.com/api-evangelist/timezonedb/refs/heads/main/examples/list-time-zone.json
  - type: Examples
    url: https://raw.githubusercontent.com/api-evangelist/timezonedb/refs/heads/main/examples/get-time-zone.json
  - type: Examples
    url: https://raw.githubusercontent.com/api-evangelist/timezonedb/refs/heads/main/examples/convert-time-zone.json
  - type: Vocabulary
    url: https://raw.githubusercontent.com/api-evangelist/timezonedb/refs/heads/main/vocabulary/timezonedb-vocabulary.json
  - type: JSONLDContext
    url: https://raw.githubusercontent.com/api-evangelist/timezonedb/refs/heads/main/json-ld/timezonedb-context.jsonld
- aid: timezonedb:timezonedb-timezones-api
  name: TimezoneDB Timezones API
  description: Operations for listing and retrieving timezone information
  humanURL: https://timezonedb.com/api
  baseURL: https://api.timezonedb.com/v2.1
  tags:
  - Timezones
  properties:
  - type: OpenAPI
    url: openapi/timezonedb-timezones-api-openapi.yml
  - type: Documentation
    url: https://timezonedb.com/api
  - type: JSONSchema
    url: https://raw.githubusercontent.com/api-evangelist/timezonedb/refs/heads/main/json-schema/list-time-zone-response.json
  - type: JSONSchema
    url: https://raw.githubusercontent.com/api-evangelist/timezonedb/refs/heads/main/json-schema/get-time-zone-response.json
  - type: JSONSchema
    url: https://raw.githubusercontent.com/api-evangelist/timezonedb/refs/heads/main/json-schema/convert-time-zone-response.json
  - type: Examples
    url: https://raw.githubusercontent.com/api-evangelist/timezonedb/refs/heads/main/examples/list-time-zone.json
  - type: Examples
    url: https://raw.githubusercontent.com/api-evangelist/timezonedb/refs/heads/main/examples/get-time-zone.json
  - type: Examples
    url: https://raw.githubusercontent.com/api-evangelist/timezonedb/refs/heads/main/examples/convert-time-zone.json
  - type: Vocabulary
    url: https://raw.githubusercontent.com/api-evangelist/timezonedb/refs/heads/main/vocabulary/timezonedb-vocabulary.json
  - type: JSONLDContext
    url: https://raw.githubusercontent.com/api-evangelist/timezonedb/refs/heads/main/json-ld/timezonedb-context.jsonld
common:
- type: AgenticAccess
  url: agentic-access/timezonedb-agentic-access.yml
- type: DomainSecurity
  url: security/timezonedb-domain-security.yml
- type: Authentication
  url: authentication/timezonedb-authentication.yml
- type: Website
  url: https://timezonedb.com/
- type: Documentation
  url: https://timezonedb.com/api
- type: Pricing
  url: https://timezonedb.com/premium
- type: Register
  url: https://timezonedb.com/register
- type: X
  url: https://twitter.com/timezonedb
- type: Plans
  url: https://raw.githubusercontent.com/api-evangelist/timezonedb/refs/heads/main/plans/timezonedb-plans-pricing.yml
- type: RateLimits
  url: https://raw.githubusercontent.com/api-evangelist/timezonedb/refs/heads/main/rate-limits/timezonedb-rate-limits.yml
- type: FinOps
  url: https://raw.githubusercontent.com/api-evangelist/timezonedb/refs/heads/main/finops/timezonedb-finops.yml
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com