API Developer Guide

QNA-Locator is a REST API. Every request must include your API key as a Bearer token. Free accounts get 500 requests/day; Pro accounts get 5,000/day.

Authentication

Pass your API key in the Authorization header as a Bearer token on every request.

Authorization: Bearer qna_live_xxxxxxxxxxxxxxxxxxxxxxxx

Endpoints

GET/api/v1/locate?zone=&street=&building=

Returns the coordinates for a specific zone/street/building number.

curl "https://qna-locator.com/api/v1/locate?zone=55&street=950&building=234" \
  -H "Authorization: Bearer qna_live_..."

{
  "zone": "55",
  "street": "950",
  "building": "234",
  "latitude": "25.25244752",
  "longitude": "51.41655439",
  "googleMapsUrl": "https://www.google.com/maps/search/?api=1&query=25.25244752,51.41655439",
  "wazeUrl": "https://waze.com/ul?q=25.25244752,51.41655439"
}

GET/api/v1/zones

Returns every zone number in the database.

curl "https://qna-locator.com/api/v1/zones" \
  -H "Authorization: Bearer qna_live_..."

{ "zones": [{ "zoneNumber": "1" }, { "zoneNumber": "2" }, ...] }

GET/api/v1/streets?zone=

Returns every street number within a zone.

curl "https://qna-locator.com/api/v1/streets?zone=55" \
  -H "Authorization: Bearer qna_live_..."

{ "zone": "55", "streets": [{ "streetNumber": "1" }, ...] }

GET/api/v1/buildings?zone=&street=

Returns every building number (with coordinates) on a street.

curl "https://qna-locator.com/api/v1/buildings?zone=55&street=950" \
  -H "Authorization: Bearer qna_live_..."

{ "zone": "55", "street": "950", "buildings": [{ "buildingNumber": "8", "latitude": "...", "longitude": "..." }] }

Errors

401 — missing or invalid API key
400 — missing required query parameter
404 — address not found in our database
429 — daily request limit exceeded for your plan

Rate limits

Limits reset daily. A 429 response includes your current tier and limit so you can decide whether to retry tomorrow or upgrade.