Documentation DiscoveryLocation and timezone search

Location and timezone search

GET/locationsRESTFrom Free

Resolve a city to timezone and geographic data.

Search known locations before chart calculation so users do not need to understand IANA timezone identifiers.

Authentication

Use Authorization: Bearer YOUR_API_KEY or X-Api-Key. Query-key authentication is deprecated compatibility behavior on supported REST routes and is rejected on Agent HTTP and MCP surfaces. Never put credentials in URLs, request bodies, or browser code.

Parameters

Name	In	Required	Description
`X-Api-Key`	header	Yes	API key used by the authorization middleware. `YOUR_API_KEY`
`query`	query	Yes	City or place search query. `Edinburgh`

Quota effect

This is a free, non-consuming lookup. Authorized calls use 0 calculation units.

Errors

Expect 400 for invalid input, 401 for a missing or malformed key, 403 when the active plan does not include this operation, and 429 when the monthly allowance is exhausted.

Related operations

RequestcURL

curl "https://api.humandesign.ai/locations?query=Edinburgh" \
  -H "X-Api-Key: YOUR_API_KEY"

Verified response examplecURL

[
  {
    "country": " United Kingdom",
    "timezone": "Europe/London",
    "asciiname": "Edinburgh",
    "admin1": " Scotland",
    "tokens": [
      "Edinburgh",
      " Scotland"
    ],
    "value": "Edinburgh, Scotland, United Kingdom"
  },
  {
    "country": " Saint Helena",
    "timezone": "Atlantic/St_Helena",
    "asciiname": "Edinburgh of the Seven Seas",
    "admin1": " Tristan da Cunha",
    "tokens": [
      "Edinburgh of the Seven Seas",
      " Tristan da Cunha"
    ],
    "value": "Edinburgh of the Seven Seas, Tristan da Cunha, Saint Helena"
  }
]

Captured from the live API on 6 August 2026. 43/43 live checks passed. Secrets and account-specific usage are removed; large payloads show a truthful excerpt.

Free includes 100 calls every month.
Free members can use every operation labelled “From Free,” including the core Agent HTTP and MCP tools.