Developer Portal — Where Address APIs

Developer Portal

Build with
Where Address APIs

Integrate verified, real-world address data into your applications. Three powerful APIs — one consistent platform — backed by Kenya’s most comprehensive address dataset.

autocomplete.json
// POST /v1/api/autocomplete { “name”: “Acaci” } { “status”: 200, “message”: “success”, “data”: { “data”: [ { “name”: “10 Acacia Court, Buruburu, Nairobi County” }, { “name”: “18 Acacia Court, Buruburu, Nairobi County” }, { “name”: “31 Acacia Court, Buruburu, Nairobi County” }, { “name”: “14 Acacia Court, Buruburu, Nairobi County” } ] } }
3 API Products
<120ms Avg Response Time
99.9% Uptime SLA
REST JSON API
Free To Get Started
API Products

Three APIs. One address platform.

Every API returns structured, verified address data from Kenya’s most comprehensive address dataset — consistent request/response shapes across all three endpoints.

Live
🔍

Address Autocomplete

Suggest real Where Address results as users type. Returns a ranked list of matching addresses from partial input.

POST /v1/api/autocomplete
  • Send a partial name to receive matching addresses
  • Fuzzy matching handles typos and partial input
  • Ideal for search-as-you-type address fields
  • Supports Swahili and English place names
// Request { “name”: “Acaci” } // Response { “status”: 200, “message”: “success”, “data”: { “data”: [ { “name”: “10 Acacia Court, Buruburu, Nairobi County” }, { “name”: “18 Acacia Court, Buruburu, Nairobi County” } ]} }
Live

Address Verification

Confirm whether a full address string exists in the Where Address dataset and retrieve its unique record ID.

POST /v1/api/address
  • Send a full address name to check if it exists
  • Returns “Exists” and a unique address ID on match
  • Ideal for checkout flows, KYC, and data cleansing
  • Prevents invalid addresses from entering your system
// Request { “name”: “31 Acacia Court, Buruburu, Nairobi County” } // Response { “status”: 200, “message”: “success”, “data”: { “data”: “Exists”, “id”: “67a091fdce728805b75483e1” } }
Live
📍

Address Search

Resolve a GPS coordinate (latitude & longitude) to the nearest verified Where Address — precise reverse geocoding for any location in Kenya.

POST /v1/api/findme
  • Submit lat/lng to find the nearest verified address
  • Returns a fully formatted address string
  • Works with any GPS or mapping SDK
  • Perfect for field apps, deliveries, and emergency dispatch
// Request { “lon”: 36.878651, “lat”: -1.284620 } // Response { “status”: 200, “message”: “success”, “data”: { “name”: “16 Mimindu Court, Buruburu, Nairobi County” } }
Quick Start

Up and running in minutes

No complicated setup. Grab an API key and make your first request with any HTTP client.

1

Create a free account

Sign up at where-address.com to receive your personal API key instantly.

2

Add your API key to requests

Pass your key in the X-API-Key header on every request.

3

Call any endpoint

All three APIs share the same base URL and authentication scheme — switch endpoints with a single path change.

4

Go live

Move to production with the same credentials. Rate limits scale with your plan.

shell
# 1. Address Autocomplete curl -X POST \ -H “X-API-Key: YOUR_KEY” \ -H “Content-Type: application/json” \ -d ‘{“name”:”Acaci”}’ \ “https://api.where-address.com/v1/api/autocomplete” # 2. Address Verification curl -X POST \ -H “X-API-Key: YOUR_KEY” \ -H “Content-Type: application/json” \ -d ‘{“address”:”13 Wa Muchiri Drive, Ruaka, Kiambu County”}’ \ “https://api.where-address.com/v1/api/address” # 3. Address Search (by coordinates) curl -X POST \ -H “X-API-Key: YOUR_KEY” \ -H “Content-Type: application/json” \ -d ‘{“lon”:36.878651,”lat”:-1.284620}’ \ “https://api.where-address.com/v1/api/findme”
Use Cases

Built for every team

From logistics to fintech, accurate addresses power the experiences your users expect.

🚚

Last-Mile Delivery

Reduce failed deliveries with verified drop-off addresses and real-time geocoding for route optimisation.

🏦

Fintech & KYC

Verify customer addresses during onboarding to meet regulatory requirements and reduce fraud exposure.

🛒

E-Commerce Checkout

Autocomplete address fields at checkout — fewer abandoned carts, fewer mis-shipped orders.

🏥

Healthcare & Emergency

Dispatch ambulances and field workers to exact, verified locations — every second counts.

🏛️

Government Services

Issue official correspondence and ID documents to standardised, resolvable addresses.

📊

Location Analytics

Enrich your datasets with county, ward, and coordinates data for richer spatial insights.

Get Started Today

Start building with
Where Address APIs

Free tier includes 1,000 requests per month across all three APIs. No credit card required to get started.