Cyber Monday Sale! Get over 30% off when you subscribe to an annual subscription 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
283ms317ms361ms702ms933ms

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:

  • lat  required

    Latitude of desired location.

  • lon  required

    Longitude of desired location.

  • city  required premium

    City name.

  • state  optional premium

    US state name or 2-letter abbreviation (for United States cities only).

  • country  optional premium

    Country name or 2-letter country code.

  • timezone  required

    Timezone of desired location (e.g. Europe/London).

Headers

  • X-Api-Key  required

    API Key associated with your account.

Sample Request Live Demo!

city
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.