Quick start
1. Request a quote
curl https://kolis.delivery/api/v1/quotes \
-H "Authorization: Bearer $KOLIS_KEY" \
-H "Content-Type: application/json" \
-d '{
"pickup": { "lat": 4.0511, "lng": 9.7679 },
"dropoff": { "lat": 4.0700, "lng": 9.7900 },
"vehicle": "moto",
"parcel": { "size": "medium", "fragile": true }
}'{
"id": "5d0b…",
"object": "quote",
"mode": "test",
"price": 2150,
"currency": "XAF",
"distance_m": 3100,
"breakdown": { "distance": 1750, "size": 300, "weight": 0, "fragile": 100 },
"expires_at": "2026-11-10T10:15:00Z"
}2. Create the delivery
curl https://kolis.delivery/api/v1/deliveries \
-H "Authorization: Bearer $KOLIS_KEY" \
-H "Idempotency-Key: order-1042" \
-H "Content-Type: application/json" \
-d '{
"quote_id": "5d0b…",
"external_ref": "CMD-1042",
"recipient": { "name": "Awa", "phone": "+237600000000" }
}'3. Track and receive statuses
Poll GET /deliveries/{id} or register a webhook endpoint. In test mode the delivery advances by itself: searching, courier assigned, parcel picked up, delivered.