Public Beta API
The public beta currently supports forward geocoding, reverse geocoding, search, routing, and ETA estimation for Nigeria-first logistics use cases. Lagos is the strongest coverage area today.
Geocode
Resolve a typed address, estate, or landmark into coordinates and a normalized label. Best results currently come from Nigeria queries, with Lagos strongest.
| Parameter | Type | Description |
|---|---|---|
| query | String | The address or place name to geocode. Supports fuzzy matching. |
| country | String | ISO 3166-1 alpha-2 code. Public beta defaults to NG. |
| limit | Integer | Maximum number of results to return. Default is 5. |
Reverse
Resolve a latitude and longitude pair into the nearest useful label in the current coverage area. This can return a landmark or nearby useful address label rather than a perfect formal street address.
| Parameter | Type | Description |
|---|---|---|
| lat | Float | Latitude in decimal degrees. |
| lng | Float | Longitude in decimal degrees. |
| result | Object | Returns the nearest known address or landmark, plus provider and confidence metadata. |
Search
Search landmarks, institutions, airports, districts, estates, and common local aliases. Use this when people search by place name rather than a formal street address.
| Parameter | Type | Description |
|---|---|---|
| query | String | Landmark, district, estate, campus, market, airport, or street query. |
| country | String | Defaults to NG for the public beta. |
| limit | Integer | Maximum 10 results in the current public contract. |
Route
Compute motorcycle-first logistics routes between two points. The public command center can resolve text inputs into points before sending the route request.
| Field | Type | Description |
|---|---|---|
| origin | Point | Latitude and longitude pair. The homepage playground can resolve address text into a point before requesting the route. |
| destination | Point | Latitude and longitude pair. |
| mode | String | Currently tuned for motorcycle delivery flows in the public beta. |
ETA
Estimate delivery travel time between two points using the same routing posture as the route endpoint, tuned for rider-style flows rather than generic car-first mapping.
| Field | Type | Description |
|---|---|---|
| origin | Point | Trip start coordinate. |
| destination | Point | Trip end coordinate. |
| response | Object | Returns distance and duration in seconds, plus provider metadata and confirmation flags. |
Authentication
| Field | Type | Description |
|---|---|---|
| X-API-Key | Header | Approved users receive production-style keys after beta review. |
| Key Storage | Practice | Use approved keys from your backend or trusted server environment only. Do not expose them in browser JavaScript or mobile bundles. |
| HTTPS | Transport | All requests must be made over TLS. |
| Playground | Anonymous | The public command center is rate-limited and intentionally narrower than approved API access. |
Access Flow
Public playground access is anonymous but intentionally rate-limited. If you need higher volume, matrix, snap, or stable production access, request full API access.
| Step | Type | Description |
|---|---|---|
| 1 | Playground | Test the public command center anonymously. Public beta limits are 20 geocode, search, or reverse requests per minute and 8 route or ETA requests per minute. |
| 2 | Request | Submit company, role, use case, expected monthly volume, and requested APIs. |
| 3 | Approval | Approved companies receive private API credentials and quota assignment. |