Skip to main content

Overview

Create a delivery using a tempDeliveryId obtained from the pricing endpoint. This converts the price estimate into an actual delivery that can be paid for and dispatched.
Required permission: delivery:create

Endpoint

Request

Headers

string
required
Your Chidori API key
string
required
Must be application/json

Body parameters

string
required
The temporary delivery ID from the pricing response
string
A descriptive name for the delivery (e.g., “Office Supplies”)
string
Type of delivery. Options: SendDelivery or RequestPickup
string
Phone number of the recipient (e.g., +2348012345678)
string
Phone number of the sender (e.g., +2348087654321)
string
Any special instructions for the driver
string
ISO 8601 datetime for scheduled deliveries (e.g., 2025-01-15T10:00:00.000Z)

Response

Success response

boolean
Always true for successful requests
object

Examples

Delivery workflow

1

Get price estimate

Call /api/pricing/single to get a tempDeliveryId
2

Create delivery

Use this endpoint with the tempDeliveryId
3

Pay for delivery

Call /api/payments/charge with the delivery ID
4

Track delivery

Use webhooks or WebSocket for real-time updates

Delivery statuses

The tempDeliveryId expires after a certain period. If you receive a “not found” error, request a new price estimate.

Next steps

Pay for Delivery

Complete the delivery by processing payment

Track Delivery

Get delivery details and status