Search City Locations: Timezone & Geo Matching

Endpoint

GET /locations

Description

Searches for cities based on a query and returns IANA timezones and geographic data. Useful when users don’t know their exact timezone.

Required Parameters

• api_key
• q – City name or partial name (e.g. London)

Example Request

GET https://api.humandesign.ai/locations?api_key=sk_test_123&q=London

Example Response

[
  {
    "city": "London",
    "country": "United Kingdom",
    "timezone": "Europe/London",
    "latitude": 51.5074,
    "longitude": -0.1278
  }
]

Use Case

Use this when building onboarding flows or input forms for birth location lookup.

See Also

• Get Human Design Chart