World Time
World Time is a simple tool for getting the current time in any city. It returns the current time, date, and more.
This API provides reliable and fast access to world time data through a simple REST interface. Built for developers who need consistent, high-quality results with minimal setup time.
To use this API, you need an API key. You can get one by creating a free account and visiting your dashboard.
View API in DirectoryEndpoint
GET https://api.apiverve.com/v1/worldtimeCode Examples
Here are examples of how to call this API in different programming languages:
curl -X GET \
"https://api.apiverve.com/v1/worldtime?city=San Francisco" \
-H "X-API-Key: your_api_key_here"const response = await fetch('https://api.apiverve.com/v1/worldtime', {
method: 'GET',
headers: {
'X-API-Key': 'your_api_key_here',
'Content-Type': 'application/json'
}
});
const data = await response.json();
console.log(data);import requests
headers = {
'X-API-Key': 'your_api_key_here',
'Content-Type': 'application/json'
}
response = requests.get('https://api.apiverve.com/v1/worldtime', headers=headers)
data = response.json()
print(data)const https = require('https');
const url = require('url');
const options = {
method: 'GET',
headers: {
'X-API-Key': 'your_api_key_here',
'Content-Type': 'application/json'
}
};
const req = https.request('https://api.apiverve.com/v1/worldtime', options, (res) => {
let data = '';
res.on('data', (chunk) => data += chunk);
res.on('end', () => console.log(JSON.parse(data)));
});
req.end();<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.apiverve.com/v1/worldtime');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'X-API-Key: your_api_key_here',
'Content-Type: application/json'
]);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);
?>package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("GET", "https://api.apiverve.com/v1/worldtime", nil)
req.Header.Set("X-API-Key", "your_api_key_here")
req.Header.Set("Content-Type", "application/json")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}require 'net/http'
require 'json'
uri = URI('https://api.apiverve.com/v1/worldtime')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Get.new(uri)
request['X-API-Key'] = 'your_api_key_here'
request['Content-Type'] = 'application/json'
response = http.request(request)
puts JSON.pretty_generate(JSON.parse(response.body))Authentication
This API requires authentication via API key. Include your API key in the request header:
X-API-Key: your_api_key_hereParameters
The following parameters are available for this API endpoint:
| Parameter | Type | Required | Location | Description | Example |
|---|---|---|---|---|---|
| city | string | Yes | query | The city name for which you want to get the current time (e.g., New York) | San Francisco |
Response
The API returns responses in JSON, XML, and YAML formats:
Example Responses
{
"status": "ok",
"error": null,
"data": {
"search": "San Francisco",
"foundCities": [
{
"city": "San Francisco",
"city_ascii": "San Francisco",
"country": "Argentina",
"iso2": "AR",
"iso3": "ARG",
"province": "Córdoba",
"timezone": "America/Argentina/Cordoba",
"time": "18:36",
"time24": "18:36:10",
"time12": "06:36:10 PM",
"date": "2025-02-20",
"day": "Thursday",
"month": "February",
"year": "2025",
"unix": "1740087370",
"dst": false,
"dst_start": "2025-02-20 18:36:10",
"dst_end": "2025-02-20 18:36:10",
"dst_name": "-03"
},
{
"city": "San Francisco",
"city_ascii": "San Francisco",
"country": "United States of America",
"iso2": "US",
"iso3": "USA",
"province": "California",
"state_ansi": "CA",
"timezone": "America/Los_Angeles",
"time": "13:36",
"time24": "13:36:10",
"time12": "01:36:10 PM",
"date": "2025-02-20",
"day": "Thursday",
"month": "February",
"year": "2025",
"unix": "1740087370",
"dst": false,
"dst_start": "2025-02-20 13:36:10",
"dst_end": "2025-02-20 13:36:10",
"dst_name": "PST"
}
]
}
}<Root>
<status>ok</status>
<error />
<data>
<search>San Francisco</search>
<foundCities>
<city>San Francisco</city>
<city_ascii>San Francisco</city_ascii>
<country>Argentina</country>
<iso2>AR</iso2>
<iso3>ARG</iso3>
<province>Córdoba</province>
<timezone>America/Argentina/Cordoba</timezone>
<time>18:36</time>
<time24>18:36:10</time24>
<time12>06:36:10 PM</time12>
<date>2025-02-20</date>
<day>Thursday</day>
<month>February</month>
<year>2025</year>
<unix>1740087370</unix>
<dst>false</dst>
<dst_start>2025-02-20 18:36:10</dst_start>
<dst_end>2025-02-20 18:36:10</dst_end>
<dst_name>-03</dst_name>
</foundCities>
<foundCities>
<city>San Francisco</city>
<city_ascii>San Francisco</city_ascii>
<country>United States of America</country>
<iso2>US</iso2>
<iso3>USA</iso3>
<province>California</province>
<state_ansi>CA</state_ansi>
<timezone>America/Los_Angeles</timezone>
<time>13:36</time>
<time24>13:36:10</time24>
<time12>01:36:10 PM</time12>
<date>2025-02-20</date>
<day>Thursday</day>
<month>February</month>
<year>2025</year>
<unix>1740087370</unix>
<dst>false</dst>
<dst_start>2025-02-20 13:36:10</dst_start>
<dst_end>2025-02-20 13:36:10</dst_end>
<dst_name>PST</dst_name>
</foundCities>
</data>
</Root>status: ok
error:
data:
search: San Francisco
foundCities:
- city: San Francisco
city_ascii: San Francisco
country: Argentina
iso2: AR
iso3: ARG
province: Córdoba
timezone: America/Argentina/Cordoba
time: 18:36
time24: 18:36:10
time12: 06:36:10 PM
date: 2025-02-20
day: Thursday
month: February
year: 2025
unix: 1740087370
dst: false
dst_start: 2025-02-20 18:36:10
dst_end: 2025-02-20 18:36:10
dst_name: -03
- city: San Francisco
city_ascii: San Francisco
country: United States of America
iso2: US
iso3: USA
province: California
state_ansi: CA
timezone: America/Los_Angeles
time: 13:36
time24: 13:36:10
time12: 01:36:10 PM
date: 2025-02-20
day: Thursday
month: February
year: 2025
unix: 1740087370
dst: false
dst_start: 2025-02-20 13:36:10
dst_end: 2025-02-20 13:36:10
dst_name: PSTResponse Structure
All API responses follow a consistent structure with the following fields:
| Field | Type | Description | Example |
|---|---|---|---|
| status | string | Indicates whether the request was successful ("ok") or failed ("error") | ok |
| error | string | null | Contains error message if status is "error", otherwise null | null |
| data | object | null | Contains the API response data if successful, otherwise null | {...} |
Response Data Fields
When the request is successful, the data object contains the following fields:
| Field | Type | Sample Value |
|---|---|---|
| search | string | "San Francisco" |
| foundCities | array | [{"city":"San Francisco","city_ascii":"San Francisco","country":"Argentina","iso2":"AR","iso3":"ARG","province":"Córdoba","timezone":"America/Argentina/Cordoba","time":"18:36","time24":"18:36:10","time12":"06:36:10 PM","date":"2025-02-20","day":"Thursday","month":"February","year":"2025","unix":"1740087370","dst":false,"dst_start":"2025-02-20 18:36:10","dst_end":"2025-02-20 18:36:10","dst_name":"-03"}, ...] |
Headers
Required and optional headers for API requests:
| Header Name | Required | Example Value | Description |
|---|---|---|---|
| X-API-Key | Yes | your_api_key_here | Your APIVerve API key. Found in your dashboard under API Keys. |
| Accept | No | application/json | Specify response format: application/json (default), application/xml, or application/yaml |
| User-Agent | No | MyApp/1.0 | Identifies your application for analytics and debugging purposes |
| X-Request-ID | No | req_123456789 | Custom request identifier for tracking and debugging requests |
| Cache-Control | No | no-cache | Control caching behavior for the request and response |
Client Libraries
To get started with minimal code, most of our APIs are available through client libraries and clients:
Error Codes
The API uses standard HTTP status codes to indicate success or failure:
| Status Code | Message | Description |
|---|---|---|
| 200 | OK | Request successful, data returned |
| 400 | Bad Request | Invalid request parameters or malformed request |
| 401 | Unauthorized | Missing or invalid API key |
| 403 | Forbidden | API key does not have permission for this endpoint |
| 429 | Too Many Requests | Rate limit exceeded, please slow down requests |
| 500 | Internal Server Error | Server error, please try again later |
Was this page helpful?
Help us improve our documentation




