Manage Deliveries
Update Delivery Status
REST API Documentation
Manage Deliveries
Update Delivery Status
curl --request POST \
--url https://dev.api.fleets.usedora.com/api/v1/deliveries/get/{delivery_uuid}{
"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": "sinoma@gmail.com",
"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
Body
Description:
| Field | Type | Required | Description | |||
|---|---|---|---|---|---|---|
delivery_uuid | string | |||||
dropoff_otp | string | required if status is delivered | ||||
pickup_otp | string | required if status is in_transit | ||||
status | string | accepted | in_transit | delivered | cancelled |
📤 Responses
✅ 200 OK
❌ 422 Bad Request
Description:
| Field | Type | Required | Description |
|---|---|---|---|
data | object | ||
data.created_at | string | ||
data.customer_detail | object | ||
data.customer_detail.created_at | string | ||
data.customer_detail.customer_address | string | ||
data.customer_detail.customer_email | any / null | ||
data.customer_detail.customer_name | string | ||
data.customer_detail.customer_phone_code | string | ||
data.customer_detail.customer_phone_number | string | ||
data.customer_detail.uuid | string | ||
data.sender_latitude | string | ||
data.sender_longitude | string | ||
data.delivery_fee | string | ||
data.delivery_type | string | ||
data.fleet_id | any / null | ||
data.items | object | ||
data.items.created_at | string | ||
data.items.item_description | string | ||
data.items.item_quantity | number | ||
data.items.item_value | string | ||
data.items.uuid | string | ||
data.order_number | string | ||
data.organization_detail | object | ||
data.organization_detail.business_address | any / null | ||
data.organization_detail.created_at | string | ||
data.organization_detail.fleet_identity_number | any / null | ||
data.organization_detail.logo | any / null | ||
data.organization_detail.phone_code | string | ||
data.organization_detail.phone_number | string | ||
data.organization_detail.updated_at | string | ||
data.organization_detail.uuid | string | ||
data.sender_detail | object | ||
data.sender_detail.created_at | string | ||
data.sender_detail.sender_address | string | ||
data.sender_detail.sender_email | any / null | ||
data.sender_detail.sender_name | string | ||
data.sender_detail.sender_phone | string | ||
data.sender_detail.sender_phonecode | string | ||
data.sender_detail.updated_at | string | ||
data.sender_detail.uuid | string | ||
data.sender_latitude | string | ||
data.sender_longitude | string | ||
data.status | string | ||
data.uuid | string | ||
message | string | ||
status | string |
{
"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": "sinoma@gmail.com",
"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"
}
curl --request POST \
--url https://dev.api.fleets.usedora.com/api/v1/deliveries/get/{delivery_uuid}{
"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": "sinoma@gmail.com",
"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"
}