Belli
Developer portal

Belli API

Use X-Belli-Token or Authorization: Bearer TOKEN. Tokens are managed from the Belli admin or customer portal, while customer settings prepare domains, webhooks, team contacts, and future integrations.

Authentication

curl -H "X-Belli-Token: YOUR_TOKEN" "https://belli.ip.mr/api/search?q=Ksar"

Keep tokens server-side where possible. For embedded maps, use short-lived page contexts and domain controls as BELLI matures.

Response contract

{ "ok": true, "results": [...] }

Clients should tolerate extra fields so BELLI can add richer geospatial intelligence without breaking apps.

Endpoint catalog

Current stable API surface for ecommerce, delivery, and future mobility workflows.

View plans

/api/account

Tenant status, quota, usage, and enabled service details.

/api/places

List tenant private places, or POST a corrected delivery landmark.

/api/search?q=Tevragh%20Zeina&limit=8

Search local and fallback map data.

/api/autocomplete?q=Ksar&limit=6

Fast suggestion endpoint for search fields.

/api/geocode?q=Clinique&lat=18.08&lng=-15.98

Search with optional origin and distance scoring.

/api/nearby?lat=18.08&lng=-15.98&limit=15

Nearest local Belli places around a driver or customer.

/api/reverse?lat=18.08&lng=-15.98

Find nearest known Belli place.

/api/route?from=18.08,-15.98&to=18.10,-15.99

Estimate distance/duration and external navigation links.

/api/optimize?from=18.08,-15.98&destinations=18.10,-15.99|18.11,-15.96

Simple nearest-first ordering for delivery stops.

/api/delivery-zones/check?lat=18.08&lon=-15.98

Quote zone coverage, delivery fee, and ETA for checkout.

/api/merchant-locations/nearest?lat=18.08&lon=-15.98

Find the nearest active branch for a customer coordinate.

/api/place-collections

Expose curated operational place lists to apps and teams.

/map?to=18.08,-15.98&label=Delivery

Embedded driver map for webviews.

Delivery SDK guides

Delivery picker Map Studio Zones

JavaScript starter

const res = await fetch("/api/search?q=Ksar", { headers: { "X-Belli-Token": token } }); const data = await res.json();

Mobile map webview

https://belli.ip.mr/map?token=YOUR_TOKEN&to=18.0735,-15.9582&label=Delivery