World Time API

https://timeapi.world
Admin
World Time API provides high-performance, global timezone, current time, and IP geolocation lookup...
Tokens:2,862
Snippets:32
Trust Score:4.8
Update:2 months ago
Show doc for...
Tokens:
Raw
### GET /timezone

Source: https://timeapi.world/examples

Get a list of all available timezones.

```APIDOC
## GET /timezone

### Description
Get a list of all available timezones.

### Method
GET

### Endpoint
https://gateway.timeapi.world/timezone

### Response
#### Success Response (200)
- **timezones** (array) - List of timezone strings
```

--------------------------------

### GET /ip/{ip}

Source: https://timeapi.world/

Retrieves the current time for a specific IP address.

```APIDOC
## GET /ip/{ip}

### Description
Returns the current time for the provided IP address.

### Method
GET

### Endpoint
/ip/{ip}

### Parameters
#### Path Parameters
- **ip** (string) - Required - The IP address to query
```

--------------------------------

### GET /ip

Source: https://timeapi.world/examples

Get current timezone information for the IP making the request.

```APIDOC
## GET /ip

### Description
Get current timezone information for the IP making the request.

### Method
GET

### Endpoint
https://gateway.timeapi.world/ip

### Response
#### Success Response (200)
- **abbreviation** (string) - Timezone abbreviation
- **datetime** (string) - Current date and time
- **dst** (boolean) - Daylight saving time status
- **timezone** (string) - Timezone name
- **utc_datetime** (string) - UTC date and time
- **utc_offset** (string) - UTC offset
```

--------------------------------

### GET /ip/{ip}

Source: https://timeapi.world/examples

Get current timezone information for a specific IP address.

```APIDOC
## GET /ip/{ip}

### Description
Get current timezone information for a specific IP address.

### Method
GET

### Endpoint
https://gateway.timeapi.world/ip/{ip}

### Parameters
#### Path Parameters
- **ip** (string) - Required - The IP address to query

### Response
#### Success Response (200)
- **abbreviation** (string) - Timezone abbreviation
- **datetime** (string) - Current date and time
- **dst** (boolean) - Daylight saving time status
- **raw_offset** (integer) - Raw offset in seconds
- **timezone** (string) - Timezone name
- **utc_datetime** (string) - UTC date and time
- **utc_offset** (string) - UTC offset
- **client_ip** (string) - The queried IP address
```

--------------------------------

### GET /geo

Source: https://timeapi.world/examples

Get geolocation information for the IP making the request.

```APIDOC
## GET /geo

### Description
Get geolocation information for the IP making the request.

### Method
GET

### Endpoint
https://gateway.timeapi.world/geo

### Response
#### Success Response (200)
- **ip** (string) - The IP address
- **latitude** (number) - Latitude coordinate
- **longitude** (number) - Longitude coordinate
- **timezone** (string) - Timezone name
- **city** (string) - City name
- **country** (object) - Country details (iso_code, name)
```

--------------------------------

### Get time by IP address

Source: https://timeapi.world/examples

Retrieves current timezone information associated with a specific IP address.

```bash
curl 'https://gateway.timeapi.world/ip/8.8.8.8'
```

--------------------------------

### Get time by timezone

Source: https://timeapi.world/examples

Retrieves current timezone information for a specific timezone string.

```bash
curl 'https://gateway.timeapi.world/timezone/America/New_York'
```

--------------------------------

### GET /timezone/{timezone}

Source: https://timeapi.world/examples

Get current timezone information for a specific timezone.

```APIDOC
## GET /timezone/{timezone}

### Description
Get current timezone information for a specific timezone.

### Method
GET

### Endpoint
https://gateway.timeapi.world/timezone/{timezone}

### Parameters
#### Path Parameters
- **timezone** (string) - Required - The timezone identifier (e.g., America/New_York)

### Response
#### Success Response (200)
- **abbreviation** (string) - Timezone abbreviation
- **datetime** (string) - Current date and time
- **day_of_week** (integer) - Day of the week
- **day_of_year** (integer) - Day of the year
- **dst** (boolean) - Daylight saving time status
- **dst_offset** (integer) - DST offset in seconds
- **raw_offset** (integer) - Raw offset in seconds
- **timezone** (string) - Timezone name
- **unixtime** (integer) - Unix timestamp
- **utc_datetime** (string) - UTC date and time
- **utc_offset** (string) - UTC offset
- **week_number** (integer) - Week number
```

--------------------------------

### GET /geo/{ip}

Source: https://timeapi.world/examples

Get geolocation information for a specific IP address.

```APIDOC
## GET /geo/{ip}

### Description
Get geolocation information for a specific IP address.

### Method
GET

### Endpoint
https://gateway.timeapi.world/geo/{ip}

### Parameters
#### Path Parameters
- **ip** (string) - Required - The IP address to query

### Response
#### Success Response (200)
- **ip** (string) - The queried IP address
- **latitude** (number) - Latitude coordinate
- **longitude** (number) - Longitude coordinate
- **accuracy_radius** (integer) - Accuracy radius
- **timezone** (string) - Timezone name
- **city** (string) - City name
- **postal_code** (string) - Postal code
- **country** (object) - Country details (iso_code, name)
- **continent** (object) - Continent details (code, name)
```

--------------------------------

### Get geolocation by IP address

Source: https://timeapi.world/examples

Retrieves geographic location details for a specific IP address.

```bash
curl 'https://gateway.timeapi.world/geo/8.8.8.8'
```

--------------------------------

### Fetch timezone data via cURL

Source: https://timeapi.world/

Retrieve current time and timezone details for a specific region using a GET request.

```bash
curl https://gateway.timeapi.world/timezone/America/Chicago
```

```json
{
"timezone": "America/Chicago",
"datetime": "2026-08-11T21:14:50.497-05:00",
"utc_datetime": "2026-08-12T02:14:50.497+00:00",
"utc_offset": "-05:00",
"abbreviation": "CDT",
"dst": true,
"unixtime": 1786500890
}
```

--------------------------------

### Get current time by requester IP

Source: https://timeapi.world/examples

Retrieves timezone information for the IP address currently making the request.

```bash
curl 'https://gateway.timeapi.world/ip'
```

--------------------------------

### Get geolocation by requester IP

Source: https://timeapi.world/examples

Retrieves geographic location details for the IP address currently making the request.

```bash
curl 'https://gateway.timeapi.world/geo'
```

--------------------------------

### List all timezones

Source: https://timeapi.world/examples

Retrieves a comprehensive list of all supported timezones.

```bash
curl 'https://gateway.timeapi.world/timezone'
```

--------------------------------

### Datetime Response Schema

Source: https://timeapi.world/schema

The schema for responses from /timezone and /ip endpoints, providing detailed time and offset information.

```APIDOC
## Datetime Response Fields

- **abbreviation** (string) - The abbreviated name of the timezone.
- **datetime** (string) - The current date and time in ISO 8601 format.
- **day_of_week** (integer) - Day of the week (0 = Sunday).
- **day_of_year** (integer) - Day of the year (1–366).
- **dst** (boolean) - Whether local time is currently in DST.
- **dst_from** (string|null) - When DST is active: when the current DST period started. When inactive: when the next DST period begins.
- **dst_offset** (integer) - DST offset in seconds.
- **dst_until** (string|null) - When DST is active: when the current DST period ends. When inactive: when the last DST period ended.
- **raw_offset** (integer) - Offset from UTC in seconds, excluding DST.
- **timezone** (string) - IANA timezone identifier.
- **unixtime** (integer) - Seconds since the Unix epoch.
- **utc_datetime** (string) - Current UTC date and time.
- **utc_offset** (string) - UTC offset in ±HH:MM format.
- **week_number** (integer) - ISO week number (1–53).
- **client_ip** (string) - IP address of the requesting client.
```

--------------------------------

### Geolocation Response Schema

Source: https://timeapi.world/schema

The schema for responses from the /geo endpoint, providing location and IP-based metadata.

```APIDOC
## Geolocation Response Fields

- **ip** (string) - The IP address that was looked up.
- **latitude** (number|null) - Latitude coordinate.
- **longitude** (number|null) - Longitude coordinate.
- **accuracy_radius** (integer|null) - Accuracy radius in kilometers.
- **timezone** (string|null) - IANA timezone for the location.
- **city** (string) - City name.
- **postal_code** (string) - Postal / ZIP code.
- **metro_code** (integer) - Metro code.
- **subdivisions** (array) - Subdivision objects { code, name }.
- **country** (object) - Country info: iso_code, name, is_in_european_union.
- **continent** (object) - Continent info: code, name.
- **is_in_european_union** (boolean) - Whether the IP is located in the EU.
- **is_anonymous_proxy** (boolean) - Whether the IP is an anonymous proxy.
- **is_satellite_provider** (boolean) - Whether the IP belongs to a satellite provider.
- **is_anycast** (boolean) - Whether the IP is an anycast address.
```
Tokens:
Raw