Deliver-It Developer API

Base URL: https://app.deliveritafrica.com/api/v1

Authentication

Authorization: Bearer {API_KEY}

Price Estimate

POST https://app.deliveritafrica.com/api/v1/estimate

{
  "pickup_lat": 0.3476,
  "pickup_lng": 32.5825,
  "dropoff_lat": 0.3136,
  "dropoff_lng": 32.5811,
  "package_size": "small"
}

Create Order

POST https://app.deliveritafrica.com/api/v1/orders

{
  "merchant_order_id": "ABC123",
  "pickup_name": "Shop",
  "pickup_phone": "+256700000000",
  "pickup_address": "Kampala",
  "pickup_lat": 0.3476,
  "pickup_lng": 32.5825,
  "dropoff_name": "Customer",
  "dropoff_phone": "+256701000000",
  "dropoff_address": "Kampala",
  "dropoff_lat": 0.3136,
  "dropoff_lng": 32.5811,
  "package_size": "small",
  "payment_method": "cash",
  "amount_to_collect": 0,
  "notes": "Handle with care"
}

Track Order

GET https://app.deliveritafrica.com/api/v1/orders/{id}

Cancel Order

POST https://app.deliveritafrica.com/api/v1/orders/{id}/cancel

Proof of Delivery

GET https://app.deliveritafrica.com/api/v1/orders/{id}/proof

Webhooks

POST https://app.deliveritafrica.com/api/v1/webhooks

{
  "webhook_url": "https://merchant.example.com/deliverit/webhook",
  "secret": "your-signing-secret"
}

# Webhook signature header:
X-DeliverIt-Signature: HMAC_SHA256(body, secret)

Postman Collection

Add a downloadable Postman collection here when ready.