Get Bulk Price

curl -X POST https://api.chidori.africa/enterprise-service/api/pricing/bulk \
  -H "X-API-Key: sk_live_xxx.yyy" \
  -H "Content-Type: application/json" \
  -d '{
    "pickup": {
      "lat": 6.5244,
      "lon": 3.3792
    },
    "stops": [
      {"lat": 6.4654, "lon": 3.4064},
      {"lat": 6.4321, "lon": 3.4567},
      {"lat": 6.4890, "lon": 3.3901}
    ]
  }'

const response = await fetch('https://api.chidori.africa/enterprise-service/api/pricing/bulk', {
  method: 'POST',
  headers: {
    'X-API-Key': 'sk_live_xxx.yyy',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    pickup: { lat: 6.5244, lon: 3.3792 },
    stops: [
      { lat: 6.4654, lon: 3.4064 },
      { lat: 6.4321, lon: 3.4567 },
      { lat: 6.4890, lon: 3.3901 }
    ]
  })
});

const data = await response.json();

import requests

response = requests.post(
    'https://api.chidori.africa/enterprise-service/api/pricing/bulk',
    headers={
        'X-API-Key': 'sk_live_xxx.yyy',
        'Content-Type': 'application/json'
    },
    json={
        'pickup': {'lat': 6.5244, 'lon': 3.3792},
        'stops': [
            {'lat': 6.4654, 'lon': 3.4064},
            {'lat': 6.4321, 'lon': 3.4567},
            {'lat': 6.4890, 'lon': 3.3901}
        ]
    }
)

data = response.json()

{
  "status": true,
  "data": {
    "totals": {
      "distanceKm": 30.12,
      "durationSec": 2400,
      "pricing": {
        "distance_km": 30.12,
        "total_cost": 7000,
        "promo_applied": false,
        "promo_percent": 0
      }
    },
    "geometry": null,
    "bulkId": "1a4f1a5e-5b79-4c4a-a0d4-4c5c7b7bb1aa",
    "tempDeliveryIds": [
      "7c9aa6f0-0f62-4bb2-a3aa-6c7bbf7b9a1a",
      "6c9aa6f0-0f62-4bb2-a3aa-6c7bbf7b9a1b",
      "5c9aa6f0-0f62-4bb2-a3aa-6c7bbf7b9a1c"
    ]
  }
}

{
  "status": false,
  "message": "Each stop must contain lat and lon numbers"
}

{
  "status": false,
  "reason": "OUT_OF_SERVICE_AREA",
  "message": "We're temporarily not delivering to this area yet."
}

curl -X POST https://api.chidori.africa/enterprise-service/api/pricing/bulk \
  -H "X-API-Key: sk_live_xxx.yyy" \
  -H "Content-Type: application/json" \
  -d '{
    "pickup": {
      "lat": 6.5244,
      "lon": 3.3792
    },
    "stops": [
      {"lat": 6.4654, "lon": 3.4064},
      {"lat": 6.4321, "lon": 3.4567},
      {"lat": 6.4890, "lon": 3.3901}
    ]
  }'

const response = await fetch('https://api.chidori.africa/enterprise-service/api/pricing/bulk', {
  method: 'POST',
  headers: {
    'X-API-Key': 'sk_live_xxx.yyy',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    pickup: { lat: 6.5244, lon: 3.3792 },
    stops: [
      { lat: 6.4654, lon: 3.4064 },
      { lat: 6.4321, lon: 3.4567 },
      { lat: 6.4890, lon: 3.3901 }
    ]
  })
});

const data = await response.json();

import requests

response = requests.post(
    'https://api.chidori.africa/enterprise-service/api/pricing/bulk',
    headers={
        'X-API-Key': 'sk_live_xxx.yyy',
        'Content-Type': 'application/json'
    },
    json={
        'pickup': {'lat': 6.5244, 'lon': 3.3792},
        'stops': [
            {'lat': 6.4654, 'lon': 3.4064},
            {'lat': 6.4321, 'lon': 3.4567},
            {'lat': 6.4890, 'lon': 3.3901}
        ]
    }
)

data = response.json()

{
  "status": true,
  "data": {
    "totals": {
      "distanceKm": 30.12,
      "durationSec": 2400,
      "pricing": {
        "distance_km": 30.12,
        "total_cost": 7000,
        "promo_applied": false,
        "promo_percent": 0
      }
    },
    "geometry": null,
    "bulkId": "1a4f1a5e-5b79-4c4a-a0d4-4c5c7b7bb1aa",
    "tempDeliveryIds": [
      "7c9aa6f0-0f62-4bb2-a3aa-6c7bbf7b9a1a",
      "6c9aa6f0-0f62-4bb2-a3aa-6c7bbf7b9a1b",
      "5c9aa6f0-0f62-4bb2-a3aa-6c7bbf7b9a1c"
    ]
  }
}

{
  "status": false,
  "message": "Each stop must contain lat and lon numbers"
}

{
  "status": false,
  "reason": "OUT_OF_SERVICE_AREA",
  "message": "We're temporarily not delivering to this area yet."
}

Overview

Calculate delivery price estimates for multiple destinations from a single pickup location. This is ideal for multi-stop deliveries or batch shipments. The endpoint returns a bulkId and individual tempDeliveryIds for each stop.

Required permission: pricing:read

Endpoint

POST /api/pricing/bulk

Request

Headers

string

required

Your Chidori API key

string

required

Must be application/json

Body parameters

object

required

Pickup location coordinates (shared for all stops)

Show properties

number

required

Latitude of the pickup location

number

required

Longitude of the pickup location

array

required

Array of destination coordinates (max 50)

Show item properties

number

required

Latitude of the stop

number

required

Longitude of the stop

Response

Success response

boolean

Always true for successful requests

object

Show properties

object

Aggregated totals for all stops

Show properties

number

Total distance in kilometers

number

Total estimated duration in seconds

object

Show properties

number

Total distance

number

Total cost for all deliveries in Naira

Whether a promotional discount was applied

Percentage discount applied

string

Encoded polyline of the complete route (can be null)

string

Bulk delivery ID for creating all deliveries at once

array

Array of temporary delivery IDs, one for each stop

Examples

curl -X POST https://api.chidori.africa/enterprise-service/api/pricing/bulk \
  -H "X-API-Key: sk_live_xxx.yyy" \
  -H "Content-Type: application/json" \
  -d '{
    "pickup": {
      "lat": 6.5244,
      "lon": 3.3792
    },
    "stops": [
      {"lat": 6.4654, "lon": 3.4064},
      {"lat": 6.4321, "lon": 3.4567},
      {"lat": 6.4890, "lon": 3.3901}
    ]
  }'

const response = await fetch('https://api.chidori.africa/enterprise-service/api/pricing/bulk', {
  method: 'POST',
  headers: {
    'X-API-Key': 'sk_live_xxx.yyy',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    pickup: { lat: 6.5244, lon: 3.3792 },
    stops: [
      { lat: 6.4654, lon: 3.4064 },
      { lat: 6.4321, lon: 3.4567 },
      { lat: 6.4890, lon: 3.3901 }
    ]
  })
});

const data = await response.json();

import requests

response = requests.post(
    'https://api.chidori.africa/enterprise-service/api/pricing/bulk',
    headers={
        'X-API-Key': 'sk_live_xxx.yyy',
        'Content-Type': 'application/json'
    },
    json={
        'pickup': {'lat': 6.5244, 'lon': 3.3792},
        'stops': [
            {'lat': 6.4654, 'lon': 3.4064},
            {'lat': 6.4321, 'lon': 3.4567},
            {'lat': 6.4890, 'lon': 3.3901}
        ]
    }
)

data = response.json()

{
  "status": true,
  "data": {
    "totals": {
      "distanceKm": 30.12,
      "durationSec": 2400,
      "pricing": {
        "distance_km": 30.12,
        "total_cost": 7000,
        "promo_applied": false,
        "promo_percent": 0
      }
    },
    "geometry": null,
    "bulkId": "1a4f1a5e-5b79-4c4a-a0d4-4c5c7b7bb1aa",
    "tempDeliveryIds": [
      "7c9aa6f0-0f62-4bb2-a3aa-6c7bbf7b9a1a",
      "6c9aa6f0-0f62-4bb2-a3aa-6c7bbf7b9a1b",
      "5c9aa6f0-0f62-4bb2-a3aa-6c7bbf7b9a1c"
    ]
  }
}

{
  "status": false,
  "message": "Each stop must contain lat and lon numbers"
}

{
  "status": false,
  "reason": "OUT_OF_SERVICE_AREA",
  "message": "We're temporarily not delivering to this area yet."
}

Error codes

Status	Message	Description
`400`	Validation error	A required field is missing or malformed, or `stops` exceeds 50
`401`	Unauthorized	Invalid or missing API key
`403`	Forbidden	API key lacks `pricing:read` permission
`422`	Out of service area	The pickup or any stop falls outside the bike service area — the whole quote fails. Carries `reason: "OUT_OF_SERVICE_AREA"`.

Creating bulk deliveries

After getting bulk pricing, you have two options:

Option 1: Create all at once using bulkId

Use the bulkId to create all deliveries in a single request:

curl -X POST https://api.chidori.africa/enterprise-service/api/deliveries/create-bulk \
  -H "X-API-Key: sk_live_xxx.yyy" \
  -H "Content-Type: application/json" \
  -d '{"bulkId": "1a4f1a5e-5b79-4c4a-a0d4-4c5c7b7bb1aa"}'

Option 2: Create individually using tempDeliveryIds

Create each delivery separately using individual tempDeliveryIds:

curl -X POST https://api.chidori.africa/enterprise-service/api/deliveries/create \
  -H "X-API-Key: sk_live_xxx.yyy" \
  -H "Content-Type: application/json" \
  -d '{"tempDeliveryId": "7c9aa6f0-0f62-4bb2-a3aa-6c7bbf7b9a1a"}'

Bulk payment

When paying for bulk deliveries, you can pay for all deliveries in the bulk by passing any deliveryId from the bulk. The system automatically calculates the total for all deliveries in that bulk.

Create Bulk Deliveries

Create multiple deliveries from a bulk pricing request

Overview

Pricing

Deliveries

Checkout

Payments

Webhooks

Real-time

Overview

Endpoint

Request

Headers

Body parameters

Response

Success response

Examples

Error codes

Creating bulk deliveries

Option 1: Create all at once using bulkId

Option 2: Create individually using tempDeliveryIds

Bulk payment

Create Bulk Deliveries

​Overview

​Endpoint

​Request

​Headers

​Body parameters

​Response

​Success response

​Examples

​Error codes

​Creating bulk deliveries

​Option 1: Create all at once using bulkId

​Option 2: Create individually using tempDeliveryIds

​Bulk payment

Create Bulk Deliveries

Overview

Endpoint

Request

Headers

Body parameters

Response

Success response

Examples

Error codes

Creating bulk deliveries

Option 1: Create all at once using bulkId

Option 2: Create individually using tempDeliveryIds

Bulk payment