Overview
Create a delivery using atempDeliveryId obtained from the pricing endpoint. This converts the price estimate into an actual delivery that can be paid for and dispatched.
Required permission:
delivery:createEndpoint
Request
Headers
Your Chidori API key
Must be
application/jsonBody parameters
The temporary delivery ID from the pricing response
A descriptive name for the delivery (e.g., “Office Supplies”)
Type of delivery. Options:
SendDelivery or RequestPickupPhone number of the recipient (e.g.,
+2348012345678)Phone number of the sender (e.g.,
+2348087654321)Any special instructions for the driver
ISO 8601 datetime for scheduled deliveries (e.g.,
2025-01-15T10:00:00.000Z)Response
Success response
Always
true for successful requestsExamples
Delivery workflow
1
Get price estimate
Call
/api/pricing/single to get a tempDeliveryId2
Create delivery
Use this endpoint with the
tempDeliveryId3
Pay for delivery
Call
/api/payments/charge with the delivery ID4
Track delivery
Use webhooks or WebSocket for real-time updates
Delivery statuses
| Status | Description |
|---|---|
PENDING | Delivery created, awaiting payment |
PAID | Payment received, awaiting driver assignment |
ASSIGNED | Driver assigned to the delivery |
PICKED_UP | Driver has picked up the package |
IN_TRANSIT | Package is on the way to destination |
DELIVERED | Package successfully delivered |
CANCELLED | Delivery was cancelled |
