Home
Guides
Application API (REST)
Webhooks
Integrations
Create Delivery
Copy
curl --request POST \
--url https://dev.api.fleets.usedora.com/api/v1/deliveries/createCopy
{
"status": "success",
"data": {
"uuid": "9fd136b9-dd33-4006-859b-5e57906f02b4",
"order_number": "41127",
"fleet_identity_number": "63471915",
"status": "Pending",
"status_label": "Pending",
"sender_longitude": null,
"sender_latitude": null,
"customer_longitude": null,
"customer_latitude": null,
"delivery_fee": 5000,
"total_delivery_amount": 5250,
"service_charge": 125,
"rider_commission": null,
"currency": "NGN",
"note": null,
"creation_mode": null,
"created_at": "2025-04-15T18:25:54.000000Z",
"pickup_at": null,
"dropoff_at": null,
"customer_detail": [],
"sender_detail": {
"uuid": "8e09f8fe-147a-4178-b3be-6b7eec4bf849",
"sender_name": "Emmanuel Chinatuka",
"sender_phone": "08087168391",
"sender_email": "[email protected]",
"sender_phonecode": "234",
"sender_address": "2 Umuleri street, Lagos",
"business_owned": false,
"created_at": "2025-04-15T18:25:54.000000Z",
"updated_at": "2025-04-15T18:25:54.000000Z"
},
"rider_info": null,
"delivery_info_from_rider": null,
"is_paid": true,
"pickup_photo": null,
"dropoff_photo": null,
"cancellation_reason": null,
"cancelled_by": {
"name": null,
"photo": null
}
},
"message": "Delivery created successfully"
}
Manage Deliveries
Create Delivery
Create Delivery
Copy
curl --request POST \
--url https://dev.api.fleets.usedora.com/api/v1/deliveries/createCopy
{
"status": "success",
"data": {
"uuid": "9fd136b9-dd33-4006-859b-5e57906f02b4",
"order_number": "41127",
"fleet_identity_number": "63471915",
"status": "Pending",
"status_label": "Pending",
"sender_longitude": null,
"sender_latitude": null,
"customer_longitude": null,
"customer_latitude": null,
"delivery_fee": 5000,
"total_delivery_amount": 5250,
"service_charge": 125,
"rider_commission": null,
"currency": "NGN",
"note": null,
"creation_mode": null,
"created_at": "2025-04-15T18:25:54.000000Z",
"pickup_at": null,
"dropoff_at": null,
"customer_detail": [],
"sender_detail": {
"uuid": "8e09f8fe-147a-4178-b3be-6b7eec4bf849",
"sender_name": "Emmanuel Chinatuka",
"sender_phone": "08087168391",
"sender_email": "[email protected]",
"sender_phonecode": "234",
"sender_address": "2 Umuleri street, Lagos",
"business_owned": false,
"created_at": "2025-04-15T18:25:54.000000Z",
"updated_at": "2025-04-15T18:25:54.000000Z"
},
"rider_info": null,
"delivery_info_from_rider": null,
"is_paid": true,
"pickup_photo": null,
"dropoff_photo": null,
"cancellation_reason": null,
"cancelled_by": {
"name": null,
"photo": null
}
},
"message": "Delivery created successfully"
}
📝 Summary
This endpoint allows users to create a new delivery request in the system. It accepts details such as sender and recipient information, delivery address, package details, and delivery preferences. Upon successful creation, it returns a unique delivery ID and the status of the delivery request.Requests
Example
Show child attributes
Show child attributes
Copy
{
"creation_date": "2025-08-28",
"delivery_fee": 0,
"iam_sender": true,
"riderid": "2ce7ff7a-2c76-4e18-b681-41121ef48631",
"send_sms": true,
"sender_address": "85 Allen Avenue, Ikeja, Lagos, Nigeria",
"sender_email": "[email protected]",
"sender_name": "Takasuki",
"sender_phone": "8131013478",
"sender_phonecode": "234",
"receivers": [
{
"customer_address": "Penthouse - DC, Demo Estate, 404, Not Found Road, Lagos, Nigeria",
"customer_name": "Victor Maduforo",
"customer_phone_number": "8131013478",
"customer_phone_code": "234",
"item_type": "manual",
"items": [
{
"item_description": "Midea 463L Top Mount Direct Cool Refrigerator - SBS (MDRT645MTU46)",
"item_quantity": 1,
"item_value": 30
}
]
}
]
}
Params
Show child attributes
Show child attributes
Description:
| Name | Location | Type | Required | Description |
|---|---|---|---|---|
body | body | object | no | none |
creation_date | body | string | yes | none |
delivery_fee | body | integer | yes | none |
iam_sender | body | boolean | yes | none |
riderid | body | string | yes | none |
send_sms | body | boolean | yes | none |
sender_address | body | string | yes | none |
sender_email | body | string | yes | none |
sender_name | body | string | yes | none |
sender_phone | body | string | yes | none |
sender_phonecode | body | string | yes | none |
receivers | body | [object] | yes | none |
customer_address | body | string | no | none |
customer_name | body | string | no | none |
customer_phone_number | body | string | no | none |
customer_phone_code | body | string | no | none |
item_type | body | string | no | none |
items | body | [object] | no | none |
item_description | body | string | no | none |
item_quantity | body | integer | no | none |
item_value | body | integer | no | none |
Responses
| HTTP Status Code | Meaning | Description | Data schema |
|---|---|---|---|
| 200 | OK | none | Inline |
| 422 | Bad Request | none | Inline |
Data Schema
Show child attributes
Show child attributes
Description:
| Name | Type | Required | Restrictions | Title | description |
|---|---|---|---|---|---|
data | object | true | none | none | |
data.status | string | true | none | none | |
data.uuid | string | true | none | none | |
data.order_number | string | true | none | none | |
data.fleet_identity_number | string | true | none | none | |
data.status | string | true | none | none | |
data.status_label | string | true | none | none | |
data.sender_longitude | null | true | none | none | |
data.sender_latitude | null | true | none | none | |
data.customer_longitude | null | true | none | none | |
data.customer_latitude | null | true | none | none | |
data.delivery_fee | integer | true | none | none | |
data.total_delivery_amount | integer | true | none | none | |
data.service_charge | integer | true | none | none | |
data.rider_commission | null | true | none | none | |
data.currency | string | true | none | none | |
data.note | null | true | none | none | |
data.creation_mode | null | true | none | none | |
data.created_at | string | true | none | none | |
data.pickup_at | null | true | none | none | |
data.dropoff_at | null | true | none | none | |
data.customer_detail | array | true | none | none | |
data.sender_detail | object | true | none | none | |
data.sender_detail.uuid | string | true | none | none | |
data.sender_detail.sender_name | string | true | none | none | |
data.sender_detail.sender_phone | string | true | none | none | |
data.sender_detail.sender_email | string | true | none | none | |
data.sender_detail.sender_phonecode | string | true | none | none | |
data.sender_detail.sender_address | string | true | none | none | |
data.sender_detail.business_owned | boolean | true | none | none | |
data.sender_detail.created_at | string | true | none | none | |
data.sender_detail.updated_at | string | true | none | none | |
data.rider_info | null | true | none | none | |
data.delivery_info_from_rider | null | true | none | none | |
data.is_paid | boolean | true | none | none | |
data.pickup_photo | null | true | none | none | |
data.dropoff_photo | null | true | none | none | |
data.cancellation_reason | null | true | none | none | |
data.cancelled_by | object | true | none | none | |
data.cancelled_by.name | null | true | none | none | |
data.cancelled_by.photo | null | true | none | none | |
message | string | true | none | none |
Copy
{
"status": "success",
"data": {
"uuid": "9fd136b9-dd33-4006-859b-5e57906f02b4",
"order_number": "41127",
"fleet_identity_number": "63471915",
"status": "Pending",
"status_label": "Pending",
"sender_longitude": null,
"sender_latitude": null,
"customer_longitude": null,
"customer_latitude": null,
"delivery_fee": 5000,
"total_delivery_amount": 5250,
"service_charge": 125,
"rider_commission": null,
"currency": "NGN",
"note": null,
"creation_mode": null,
"created_at": "2025-04-15T18:25:54.000000Z",
"pickup_at": null,
"dropoff_at": null,
"customer_detail": [],
"sender_detail": {
"uuid": "8e09f8fe-147a-4178-b3be-6b7eec4bf849",
"sender_name": "Emmanuel Chinatuka",
"sender_phone": "08087168391",
"sender_email": "[email protected]",
"sender_phonecode": "234",
"sender_address": "2 Umuleri street, Lagos",
"business_owned": false,
"created_at": "2025-04-15T18:25:54.000000Z",
"updated_at": "2025-04-15T18:25:54.000000Z"
},
"rider_info": null,
"delivery_info_from_rider": null,
"is_paid": true,
"pickup_photo": null,
"dropoff_photo": null,
"cancellation_reason": null,
"cancelled_by": {
"name": null,
"photo": null
}
},
"message": "Delivery created successfully"
}
⌘I