MZUZI API v1 · live

Verified locations for Africa, in one API

Turn an MLIC into a point a rider can reach, verify a business or a customer's address, search the business directory and link your own records to the places they serve, across 25 countries.

25countries
30 daysfree trial, no card
< 200 mstypical response
REST + JSONOpenAPI 3 spec
curl "https://api.mzuzigroup.com/v1/delivery-points/TEST%20UG%201A" \
  -H "Authorization: Bearer $MZUZI_KEY"
200 OK Response
{
  "data": {
    "mlic": "TEST UG 1A",
    "latitude": 0.3976,
    "longitude": 32.6061,
    "entrance": "Black gate facing the main road",
    "landmark": "Opposite the fuel station",
    "directions": "Second turn left after the market, third house",
    "category": "domestic",
    "verification": { "status": "field_verified" }
  }
}
What you can build

Every endpoint answers one real-world question

Where is this place, who runs this business, is this address real, and who should we send to fix it.

Delivery points

A customer gives you their MLIC at checkout; you get coordinates, entrance and directions. Homes share only with the owner's approval.

GET/delivery-points/{mlic}

Locations & areas

Countries down to villages, plus every MLIC place with its full area chain. Geocode and reverse-geocode included.

GET/locations/{mlic}

Business directory

Verified businesses and branches with MLIC, address, hours and contacts. Search by name, category or distance.

GET/search?q=pharmacy

Products & services

What each verified business sells, with categories and attributes, ready for marketplaces and comparison apps.

GET/products

Verification

Confirm a business at an MLIC, or a customer's private address, as a yes/no answer. No personal data leaves MZUZI.

POST/verify/mlic

Webhooks

Signed events when businesses change, owners approve sharing, or customers apply for your services.

POST/webhooks
Get going in minutes

From sign-up to first call

  1. Create your organisation

    Sign in with your MZUZI account, describe what you are building and pick a trial country.

  2. Generate a test key

    Test keys return sample data, never expire and are never billed. Restrict them by IP, domain or app ID.

  3. Call the API

    Use the samples above, the Postman collection or the OpenAPI spec with your favourite client generator.

  4. Go live

    Switch to a live key when you are ready. Upgrade any time; usage and limits are in your dashboard.

Enterprise & government

Built for utilities, banks and public agencies

Partnership tenants get their own workspace with named officer accounts, and the controls their security teams ask for.

  • OAuth 2.0 client credentials with IP allowlists and one-hour tokens
  • Bulk exports of areas, places, businesses and products as CSV or JSON
  • Partner links: attach your meter, account or parcel numbers to MLICs
  • Field visits and service applications straight from the MZUZI app
  • Purpose logging and a full audit trail on every request
curl -X POST https://api.mzuzigroup.com/oauth/token \
  -u "$CLIENT_ID:$CLIENT_SECRET" \
  -d grant_type=client_credentials \
  -d scope="partner.links export.bulk"
200 OK Response
{
  "access_token": "mzat_...",
  "token_type": "Bearer",
  "expires_in": 3600,
  "scope": "partner.links export.bulk"
}
Pricing

Start free, pay as you grow

Every plan includes test keys, the dashboard and webhooks where listed. Paid plans from $29 a month.

Trial
Free for 30 days

30 days free, no card. One country, locations, directory and delivery points.

  • 1 country
  • 5,000 calls in total
  • 30 requests / minute
  • Locations: countries, areas, MLIC places
  • Business directory
  • Delivery points (MLIC to a reachable point)
Growth
$99 / month

Up to 5 countries. Adds search, nearby and geocoding.

  • Up to 5 countries
  • 100,000 calls / month
  • 120 requests / minute
  • Locations: countries, areas, MLIC places
  • Business directory
  • Delivery points (MLIC to a reachable point)
  • Search, nearby, geocoding
  • Products and services catalogue
Business
$299 / month

All countries. Adds MLIC and business verification, webhooks and area statistics.

  • All countries
  • 500,000 calls / month
  • 300 requests / minute
  • Locations: countries, areas, MLIC places
  • Business directory
  • Delivery points (MLIC to a reachable point)
  • Search, nearby, geocoding
  • Business verification by MLIC
  • Private MLIC verification (yes/no, after KYB)
  • + 3 more
Coverage

Where MZUZI works today

AngolaBotswanaBurundiComorosDemocratic Republic of Congo (DRC)DjiboutiEritreaEswatiniEthiopiaKenyaLesothoMadagascarMalawiMauritiusMozambiqueNamibiaRwandaSeychellesSomaliaSouth AfricaSouth SudanTanzaniaUgandaZambiaZimbabwe
Questions

Good to know

What is an MLIC?

The MZUZI Location Identification Code: a short, human-friendly code for a verified place (a home, shop, office or plot). People share it like a phone number; your app turns it into a point on the map with directions.

Can I see where people live?

No. Home addresses resolve only after the owner approves your request in the MZUZI app, for a stated purpose and a limited time. Verification endpoints answer yes or no without revealing anything else.

What counts as a billable call?

Successful data calls with a live key. Status, usage and reference endpoints, test keys, refused calls and our own server errors are free. Bulk exports count as one call per 1,000 rows.

What happens when I hit my quota?

By default calls stop with a clear error until the next period. You can turn on overage in billing to keep working and pay per 1,000 calls.

Do you offer SLAs and data agreements?

Yes, on Enterprise and partnership plans, together with OAuth clients, IP allowlists, audit exports and named officer accounts.

Ship your first location feature today

Free for 30 days. Test keys forever. No card needed.