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.

Explore APIs Quick Start

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” }
  ]}
}

View docs

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”
  }
}

View docs

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”
  }
}

View docs

Quick Start

Up and running in minutes

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

Create a free account

Add your API key to requests

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

Call any endpoint

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

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.

Get Your Free API Key Read the Docs

Build withWhere Address APIs

Three APIs. One address platform.

Address Autocomplete

Address Verification

Address Search

Up and running in minutes

Create a free account

Add your API key to requests

Call any endpoint

Go live

Built for every team

Last-Mile Delivery

Fintech & KYC

E-Commerce Checkout

Healthcare & Emergency

Government Services

Location Analytics

Start building withWhere Address APIs

Build with
Where Address APIs

Start building with
Where Address APIs