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

44.9/100 developing ▬ flat Agent 35/100 agent ready Full breakdown ↓
scored 2026-08-25 · rubric v0.14.0

AccessFreemiumSelf serve⚡ Free to try

2 APIs

Timezone TimeGeographic CoordinatesDSTUTC OffsetTime ConversionLocation

Kin Score

Kin Score How this is scored →
scored 2026-08-25 · rubric v0.14.0

Composite quality — 44.9/100 · developing

Contract Quality 17.2 / 25

Developer Ergonomics 4.3 / 20

Access Clarity 12.6 / 20

Operational Transparency 2.7 / 13

Contract Governance 1.2 / 12

Discoverability 6.9 / 10

Agent readiness — 35/100 · agent ready

Machine-Readable Contract 18 / 18

Agentic Access Contract 10 / 10

Documented Reversibility 6 / 6

MCP Server 0 / 12

Machine-Readable Auth 10 / 10

Idempotency 9 / 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 4 / 4

Delegated User Identity 0 / 6

Protected Resource Metadata 0 / 5

Registration Without a Human 0 / 6

Agentic Commerce Surface 0 / 5

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.

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.

JSON Schema 3

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

Examples 3

Example request and response payloads for these APIs.

AGENTIC

Resources

Get Started 1

Portal, sign-up, and the first successful call

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

Source (apis.yml)

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.23'
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

Work with this as data

Every provider here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for providers

9 MCP tools reach this

find_providersBrowse and filter every provider in the catalog.
get_provider_artifactsEvery artifact this provider publishes, grouped by type.
get_provider_operationsEvery operation across all of their OpenAPIs — one call instead of parsing every spec.
get_provider_toolsEvery MCP tool they ship, with the operation each wraps.
get_provider_evidenceHow each part of their score was established. Free — the basis for a claim should not sit behind it.
get_provider_ratingPRO — composite, band, trend and facet scores.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools

Call it yourself

curl for this page

This provider

curl "https://apis.io/api/v1/providers/timezonedb"

All providers

curl "https://apis.io/api/v1/providers?limit=25"

Every operation they expose

curl "https://apis.io/api/v1/providers/timezonedb/operations?limit=25"

How their score was established

curl "https://apis.io/api/v1/providers/timezonedb/evidence"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.