Holiday Sale! Get over 30% off when you subscribe to an annual plan!

World Time API

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

API Status

Online - All Systems Operational

API Response Times

Average
P50
P75
P90
P95
308ms348ms378ms639ms1074ms

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

  • timezone  required

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

    • — or —
  • lat  required premium

    Latitude of desired location.

  • lon  required premium

    Longitude of desired location.

    • — or —
  • city  required 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.

Sample Request Live Demo!

city premium
state premium
country premium
lat
lon

Try this API endpoint with all available parameters in our API playground

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
1 2 3 4 5 6 7 8 9 10 11 12 { "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.