Skip to content
Developers

Address codes and public links

Every published address has a short public code. Read an address by its code, or share its public page.

Base URLhttps://makani-k8s.lamah.com

Read an address by its code

A public code names one address in a country. It is the publicCode of search and lookup results, and it stays the same for the life of the address.

An unknown code answers 404 ADDRESS_CODE_NOT_FOUND.

GET/v1/addresses/{countryCode}/code/{publicCode}Scopeaddresses:read
curl "https://makani-k8s.lamah.com/v1/addresses/QA/code/QA-street-3-984-2?locale=en" \  -H "x-api-key: $MAKANI_API_KEY"

Without a key

The same address can be read without a key, for a public page or a shared link. This answer also carries the point (latitude, longitude) and the address in both languages. Add countryCode only when the same code exists in more than one country.

Public endpoints are limited per network address and per day, and are meant for people, not for bulk reads. Use a key for your application's traffic.

GET/v1/public/addresses/code/{publicCode}No key needed
curl "https://makani-k8s.lamah.com/v1/public/addresses/code/QA-street-3-984-2?locale=en"