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 Geo API

The Geo API from World Time API — 3 operation(s) for geo.

World Time API Geo 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 Geo. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, pricing, and a GitHub repository.

This API exposes 3 operations across 3 paths, and defines 5 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/.

3 operations 3 paths 5 schemas 3 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 3

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

Geo 3
GET
/geo
request geolocation data based on the ip of the request. note: this is a "best guess" obtained from open-source data.
→ 200default
GET
/geo/{ip}
request geolocation data for a specific IPv4 or IPv6 address. note: this is a "best guess" obtained from open-source data.
1 param → 200default
GET
/geo/{ip}.txt
request geolocation data for a specific IPv4 or IPv6 address. note: this is a "best guess" obtained from open-source data.
1 param → 200default

Schemas 5

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

GeoSubdivision
object
2 properties 2 required
ErrorTextResponse
string
details about the error encountered in plain text
GeoJsonResponse
object
15 properties 15 required
GeoTextResponse
string
geolocation details, as per the GeoJsonResponse response, in the format key: value, one item per line
ErrorJsonResponse
object
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

worldtimeapi-geo-api-openapi.yml Raw ↑

Other APIs World Time API publishes across the network.

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