Get API Key
API Reference

PMAP Developer API

Programmatic access to Africa's most comprehensive mapping platform — geocoding, routing, places, markets, payments, ride-hailing and hotels. All in one unified API.

REST over HTTPS
JSON responses
Sandbox mode
17 endpoints
1 000 free calls/mo

Quickstart

3 steps
Step 1

Create your account

Sign up at pechmap.com and navigate to the Developer Dashboard to create your first project.

https://pechmap.com/developers/dashboard
Step 2

Make your first call

Copy your API key and run this geocoding request to verify everything works.

curl -G https://pechmap.com/api/v1/geocode \
  -H "Authorization: Bearer pm_live_YOUR_KEY" \
  --data-urlencode "q=Accra Central"
Step 3

Read the response

Parse the JSON results array. Each result includes id, name, lat, lng, and address.

{ "results": [{ "id": "pmap:gh01", "name": "Accra Central",
  "lat": 5.5502, "lng": -0.2174, "country_code": "GH" }] }

Authentication

Pass your API key in every request: Authorization: Bearer pm_live_YOUR_KEY. Get your key from the developer dashboard. Use pm_test_ keys for sandbox testing without affecting real data.

Rate Limits

Free

1 000 req/month

Developer

50 000 req/month

Enterprise

Unlimited + SLA

Geocoding

2 endpoints
API Key

Convert a text query into geographic coordinates. Searches PMAP's community database first, then supplements with OpenStreetMap data.

Parameters

NameDescription
qSearch text, e.g. "Lagos Island" or "Shoprite Ikeja"
limitMaximum results to return (1-20, default 5)
countryISO 3166-1 alpha-2 country code filter, e.g. "NG"

cURL

curl -G https://pechmap.com/api/v1/geocode \
  -H "Authorization: Bearer pm_live_YOUR_API_KEY" \
  --data-urlencode "q=Lagos Island" \
  -d "limit=5" \
  -d "country=NG"

Routing

1 endpoint

Fleet & Mobility

3 endpoints

Places

2 endpoints

Businesses

1 endpoint

Markets

2 endpoints

PMAP Pay

1 endpoint

Ride

1 endpoint

Hotels

1 endpoint

Addresses

3 endpoints

Error Codes

CodeMeaning
200Request succeeded. Response body contains the requested data.
400Missing or invalid parameter. Check the error.message field for details.
401API key missing, malformed or revoked. Re-check the Authorization header.
403API key valid but lacks permission for this endpoint (e.g. pay endpoints require Pay access).
404Resource ID does not exist (e.g. unknown market ID).
429Rate limit exceeded. Check the Retry-After header and upgrade your plan if needed.
500Unexpected internal error. Retry with exponential back-off or contact support.

Ready to build on Africa's map?

Create your developer account, get a free API key, and make your first call in under 60 seconds.