Save over 30% 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.

Checking API status...

/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

  • lat  required

    Latitude of desired location.

  • lon  required

    Longitude of desired location.

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

— or —
  • timezone  required

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

Headers

  • X-Api-Key  required

    API Key associated with your account.

Request URL

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

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.