NewConnect Claude, Gemini, ChatGPT, and other AI agents to API Ninjas via our MCP server →

World Time API

The World Time API provides the current date and time for any city, latitude/longitude coordinates or timezone in the world.

(4.2)

From 7,436 users

1,700+

Applications using this API

API Status

Online - All Systems Operational

API Response Times

Average
P50
P75
P90
P95
344ms380ms414ms629ms1198ms

Didn't find what you were looking for? Suggest an improvement

/v1/worldtime GET

https://api.api-ninjas.com/v1/worldtime

Get the current date and time by city/state/country, location coordinates (latitude/longitude), or timezone.

Parameters

One of the following parameter combinations must be provided:

  • timezone
  • lat and lon
  • city (optionally with state and/or country)
  • timezone  optional

    Timezone name (e.g. Europe/London).

  • lat  optional premium

    Latitude of desired location.

  • lon  optional premium

    Longitude of desired location.

  • city  optional premium

    City name.

  • state  optional premium

    US state (for United States cities only).

  • country  optional premium

    Country name.

Headers

  • X-Api-Key  required

    API Key associated with your account.

Response

A JSON object with the following fields or an error if the request is unsuccessful.

  • timezone

    IANA timezone identifier (for example Europe/London).

  • datetime

    Local date and time string (YYYY-MM-DD HH:MM:SS).

  • date

    Current date in YYYY-MM-DD format.

  • year

    Current year as a 4-digit string.

  • month

    Current month as a 2-digit string between 01 and 12 (inclusive).

  • day

    Current day of the month as a 2-digit string between 01 and 31 (inclusive).

  • hour

    Current hour in 24-hour format as a 2-digit string between 00 and 23 (inclusive).

  • minute

    Current minute as a 2-digit string between 00 and 59 (inclusive).

  • second

    Current second as a 2-digit string between 00 and 59 (inclusive).

  • day_of_week

    Name of the day of the week (for example Sunday).

Sample Request Live Demo!

city premium
state premium
country premium
lat
lon

Try our APIs in the API playground

Sign up for a free API key to get started — no credit card required.

https://api.api-ninjas.com/v1/worldtime?city=London

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON
{
    timezone:"Europe/London",
    datetime:"2022-09-18 19:16:43",
    date:"2022-09-18",
    year:"2022",
    month:"09",
    day:"18",
    hour:"19",
    minute:"16",
    second:"43",
    day_of_week:"Sunday"
}

Code Examples

1 2 curl -X GET "https://api.api-ninjas.com/v1/worldtime?city=london" \ -H "X-Api-Key: YOUR_API_KEY"

If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.

Frequently Asked Questions

  • Yes, but you must have a premium subscription. Commercial use of the World Time API is not permitted on the free tier. See our pricing page to choose a plan that fits your needs.
  • Sign up for a free account to instantly get your API key, then pass it in the X-Api-Key header on every request. The documentation above includes ready-to-run examples in cURL, Python, JavaScript, Node.js, and more.
  • Your API requests will simply be denied once you hit your monthly quota — you will never be charged more than the plan you signed up for. To increase your quota, you can upgrade your plan any time on our pricing page.
  • The API responds with a standard HTTP status code and a JSON error message describing the problem. See our error codes reference for the full list of codes and how to resolve each one, or contact support if you need help.
  • You can query by IANA timezone name (e.g. Europe/London), by lat and lon coordinates, or by city (optionally narrowed with state and country). If you only have coordinates or a place name, our Geocoding API can resolve them first.
  • The timezone parameter is available on all plans, but querying by lat/lon, city, state, or country requires a premium subscription, as noted on each parameter; see our pricing page for details.
  • Each response returns the timezone, a full datetime string (YYYY-MM-DD HH:MM:SS), and the individual date, year, month, day, hour, minute, second, and day_of_week fields; if a request fails you will instead receive an error.
  • The World Time API returns the live local date and time for a location, while the Timezone API focuses on the timezone metadata itself; you can also resolve city details with the City API.