New Booking
Request delivery
POST
{baseUrl}/deliveries
To create a new delivery booking, provide the following details:
Pick-up Details Include the necessary pick-up information such as address, contact person etc.
Drop-off Details Include drop-off information such as address, contact person etc.
Optional Customer Contact You can specify a customer by including
bookingName
and either:bookingEmail: The customer's email address.
bookingPhone: The customer's phone number.
Note: If neither field is provided, the delivery will not be associated with a customer.
bookingName
is optional but can be included to specify the customer's name.Order Type Set the
orderType
toPROCESSING
. This ensures that the delivery will be handled by your partners.Optional Partner Assignment You can assign the delivery to a specific partner at the time of booking by using the
assignedPartner
field. Provide the partner's ID, which can be obtained from the Get Delivery Price Estimate request.
Headers
app_id*
String
app_secret*
String
Request Body
pickup*
object
Pickup details
drops*
array
Dropoff locations and details
orderType*
string
bookingName
string
specifies the name of the customer
bookingPhone
string
specifies phone number of customer
bookingEmail
string
specifies email of customer
pickup object
long
Longitude of specified pickup address
Number
Optional
lat
Latitude of specified pickup address
Number
Optional
locationCode
Maps to an area, local government, or province connected to the address
String
Optional
city
Pickup city
String
Optional
state
Pickup state
String
Optional
country
Pickup country
String
Optional
address2
Alternative pickup address
String
Optional
address
Pickup address
String
Required
pickupName
Pickup name
String
Required
pickupEmail
Pickup email
String
Optional
pickupNumber
Pickup phone number
String
Required
altPickupNumber
Alternative pickup phone number
String
Optional
postalCode
Pickup address postal code
String
Optional
note
Pickup note
String
Optional
pickupDate
The date scheduled for the pickup
String
Optional
Drop Object
long
Longitude of the drop-off address
Number
Optional
lat
Latitude of the drop-off address
Number
Optional
locationCode
Maps to a specific area or region connected to the address
String
Optional
city
Drop-off city
String
Optional
state
Drop-off state
String
Optional
country
Drop-off country
String
Default: "NG"
address
Drop-off address
String
Required
address2
Alternative drop-off address
String
Optional
recipientName
Recipient’s name
String
Required
recipientNumber
Recipient’s phone number
String
Required
recipientEmail
Recipient’s email address
String
Optional
altRecipientNumber
Alternative recipient phone number
String
Optional
express
Indicates if express delivery is requested
Boolean
Optional
category
Delivery category
String
Optional
note
Additional delivery notes
String
Optional
value
Value of the item being delivered
Number
Optional
description
Description of the item
String
Optional
height
Height of the package (cm)
Number
Optional
length
Length of the package (cm)
Number
Optional
width
Width of the package (cm)
Number
Optional
weight
Weight of the package (kg)
Number
Optional
assignedPartner
ID of the assigned partner
String
Optional
postalCode
Drop-off address postal code
String
Optional
categoryId
ID of the delivery category
String
Optional
podAmount
Proof of delivery amount
Number
Optional
amount
Delivery amount. If provided, it will override the default calculated amount for the delivery
Number
Optional
partnerFee
Fee charged by the partner
Number
Optional
estimatedPickupWindow
Estimated pickup time window (date and time range). If provided, it will override the default pickup window for the delivery
Object
Optional (date, start, end)
estimatedDropoffWindow
Estimated drop-off time window (date and time range). If provided, it will override the default drop-off window for the delivery
Object
Optional (date, start, end)
Sample Success Data
Sample Success Data(Pay on Delivery)
Sample Error Data
A 400 Bad Request is returned for any missing required field.
Last updated