Home
Guides
Application API (REST)
Webhooks
Integrations
Update Delivery Status
Copy
curl --request POST \
--url https://dev.api.fleets.usedora.com/api/v1/deliveries/update_statusCopy
{
"status": "success",
"data": {
"uuid": "e85616da-906c-4984-8980-069e7f3b2cd9",
"order_number": "664481112612",
"status": "Order Accepted",
"delivery_type": "intra_state",
"sender_longitude": "7.4724033",
"sender_latitude": "9.0820999",
"customer_longitude": "7.4974495",
"customer_latitude": "9.0339358",
"created_at": "2023-10-30T18:45:33.000000Z",
"customer_detail": {
"id": "8670aeb6-8299-4f0f-8915-31c7db66a7c0",
"customer_name": "TundeNasri",
"customer_email": "[email protected]",
"customer_state_id": 304,
"customer_phone_number": "08065302534",
"customer_phone_code": "234",
"customer_address": "12 Ahmadu Bello way, Central Business District, Abuja",
"created_at": "2023-10-30T18:45:33.000000Z"
},
"delivery_detail": {
"uuid": "dc09555f-42ac-426b-963c-7d301ea4deb3",
"sender_name": "Ac Nice",
"sender_phone": "08087168391",
"sender_phonecode": "234",
"sender_address": "T-pumpy estate, phase 20 lugbe, Abuja",
"delivery_total_order_value": "10000.00",
"delivery_number_of_parcels": 1,
"delivery_unit_weight": "10.00",
"created_at": "2023-10-30T18:45:33.000000Z",
"updated_at": "2023-10-30T18:45:33.000000Z"
},
"items": [
{
"uuid": "aee2ca50-bed0-40b3-90da-534097c39f91",
"item_description": "Freshfish",
"item_quantity": 1,
"item_weight": "10.00",
"item_value": "10000.00",
"created_at": "2023-10-30T18:45:33.000000Z"
}
],
"organization_detail": {
"uuid": "355c96cd-aa77-459e-9107-1223bea38f9b",
"business_address": "Aso Housing Estate, Airport road, Abuja",
"country_id": 161,
"state_id": 303,
"city": "Abuja",
"logo": "https://usedora-bucket-dev.s3.amazonaws.com/provider-logos/mwFmcQ7ppveoNULRwL3AEyKtwoHT2KViXte8AYJA.jpg",
"created_at": "2023-10-15T10:57:05.000000Z",
"updated_at": "2023-10-28T16:40:21.000000Z"
}
},
"message": "Delivery status updated"
}
Manage Deliveries
Update Delivery Status
Update Delivery Status
Copy
curl --request POST \
--url https://dev.api.fleets.usedora.com/api/v1/deliveries/update_statusCopy
{
"status": "success",
"data": {
"uuid": "e85616da-906c-4984-8980-069e7f3b2cd9",
"order_number": "664481112612",
"status": "Order Accepted",
"delivery_type": "intra_state",
"sender_longitude": "7.4724033",
"sender_latitude": "9.0820999",
"customer_longitude": "7.4974495",
"customer_latitude": "9.0339358",
"created_at": "2023-10-30T18:45:33.000000Z",
"customer_detail": {
"id": "8670aeb6-8299-4f0f-8915-31c7db66a7c0",
"customer_name": "TundeNasri",
"customer_email": "[email protected]",
"customer_state_id": 304,
"customer_phone_number": "08065302534",
"customer_phone_code": "234",
"customer_address": "12 Ahmadu Bello way, Central Business District, Abuja",
"created_at": "2023-10-30T18:45:33.000000Z"
},
"delivery_detail": {
"uuid": "dc09555f-42ac-426b-963c-7d301ea4deb3",
"sender_name": "Ac Nice",
"sender_phone": "08087168391",
"sender_phonecode": "234",
"sender_address": "T-pumpy estate, phase 20 lugbe, Abuja",
"delivery_total_order_value": "10000.00",
"delivery_number_of_parcels": 1,
"delivery_unit_weight": "10.00",
"created_at": "2023-10-30T18:45:33.000000Z",
"updated_at": "2023-10-30T18:45:33.000000Z"
},
"items": [
{
"uuid": "aee2ca50-bed0-40b3-90da-534097c39f91",
"item_description": "Freshfish",
"item_quantity": 1,
"item_weight": "10.00",
"item_value": "10000.00",
"created_at": "2023-10-30T18:45:33.000000Z"
}
],
"organization_detail": {
"uuid": "355c96cd-aa77-459e-9107-1223bea38f9b",
"business_address": "Aso Housing Estate, Airport road, Abuja",
"country_id": 161,
"state_id": 303,
"city": "Abuja",
"logo": "https://usedora-bucket-dev.s3.amazonaws.com/provider-logos/mwFmcQ7ppveoNULRwL3AEyKtwoHT2KViXte8AYJA.jpg",
"created_at": "2023-10-15T10:57:05.000000Z",
"updated_at": "2023-10-28T16:40:21.000000Z"
}
},
"message": "Delivery status updated"
}
📝 Summary
This endpoint allows updating the status of a specific delivery. The status can reflect various stages of the delivery process, such as pending, in transit, completed, or failed. This is typically used when there is a change in the delivery’s current state, helping to track its progress.Requests
Example
Show child attributes
Show child attributes
Copy
delivery_uuid: "{{delivery_uuid}}"
status: in_transit
pickup_otp: "097857"
dropoff_otp: "098798"
note: Reason for cancellation
Params
Show child attributes
Show child attributes
Description:
| Name | Location | Type | Required | Description | |||
|---|---|---|---|---|---|---|---|
body | body | object | no | none | |||
delivery_uuid | body | string | yes | none | |||
status | body | string | yes | accepted | in_transit | delivered | cancelled |
pickup_otp | body | string | no | required if status is in_transit | |||
dropoff_otp | body | string | no | required if status is delivered | |||
note | body | string | no | Reason for cancellation |
Responses
| HTTP Status Code | Meaning | Description | Data schema |
|---|---|---|---|
| 200 | OK | none | Inline |
| 422 | Bad Request | none | Inline |
Copy
{
"status": "success",
"data": {
"uuid": "e85616da-906c-4984-8980-069e7f3b2cd9",
"order_number": "664481112612",
"status": "Order Accepted",
"delivery_type": "intra_state",
"sender_longitude": "7.4724033",
"sender_latitude": "9.0820999",
"customer_longitude": "7.4974495",
"customer_latitude": "9.0339358",
"created_at": "2023-10-30T18:45:33.000000Z",
"customer_detail": {
"id": "8670aeb6-8299-4f0f-8915-31c7db66a7c0",
"customer_name": "TundeNasri",
"customer_email": "[email protected]",
"customer_state_id": 304,
"customer_phone_number": "08065302534",
"customer_phone_code": "234",
"customer_address": "12 Ahmadu Bello way, Central Business District, Abuja",
"created_at": "2023-10-30T18:45:33.000000Z"
},
"delivery_detail": {
"uuid": "dc09555f-42ac-426b-963c-7d301ea4deb3",
"sender_name": "Ac Nice",
"sender_phone": "08087168391",
"sender_phonecode": "234",
"sender_address": "T-pumpy estate, phase 20 lugbe, Abuja",
"delivery_total_order_value": "10000.00",
"delivery_number_of_parcels": 1,
"delivery_unit_weight": "10.00",
"created_at": "2023-10-30T18:45:33.000000Z",
"updated_at": "2023-10-30T18:45:33.000000Z"
},
"items": [
{
"uuid": "aee2ca50-bed0-40b3-90da-534097c39f91",
"item_description": "Freshfish",
"item_quantity": 1,
"item_weight": "10.00",
"item_value": "10000.00",
"created_at": "2023-10-30T18:45:33.000000Z"
}
],
"organization_detail": {
"uuid": "355c96cd-aa77-459e-9107-1223bea38f9b",
"business_address": "Aso Housing Estate, Airport road, Abuja",
"country_id": 161,
"state_id": 303,
"city": "Abuja",
"logo": "https://usedora-bucket-dev.s3.amazonaws.com/provider-logos/mwFmcQ7ppveoNULRwL3AEyKtwoHT2KViXte8AYJA.jpg",
"created_at": "2023-10-15T10:57:05.000000Z",
"updated_at": "2023-10-28T16:40:21.000000Z"
}
},
"message": "Delivery status updated"
}
⌘I