Manage Deliveries
Assign Delivery
REST API Documentation
Manage Deliveries
Assign Delivery
curl --request POST \
--url https://dev.api.fleet.usedora.com/api/v1/deliveries/assign/%7B{rider_uuid}%7D{
"status": "success",
"data": [
{
"uuid": "e207ecc7-dcab-439e-88e8-f3e630e53697",
"order_number": "387451602924",
"fleet_id": null,
"status": "Awaiting Pickup",
"delivery_type": "intra_state",
"sender_longitude": "7.3445666",
"sender_latitude": "8.95625",
"customer_longitude": "7.4974495",
"customer_latitude": "9.0339358",
"delivery_fee": "NGN3,000.00",
"created_at": "2023-12-05T00:51:00.000000Z",
"customer_detail": {
"uuid": "caf911a3-7b66-4599-9b3a-aa26d7730e69",
"customer_name": "TundeNasri",
"customer_email": null,
"customer_phone_number": "08065302534",
"customer_phone_code": "234",
"customer_address": "12 Ahmadu Bello way, Central Business District, Abuja",
"created_at": "2023-12-04T22:03:06.000000Z"
},
"sender_detail": {
"uuid": "cadb63c6-577b-4b30-ac6a-c4ca30884631",
"sender_name": "Nuel Geek",
"sender_phone": "08087168391",
"sender_email": null,
"sender_phonecode": "234",
"sender_address": "Aso housing estate, lugbe",
"created_at": "2023-12-05T00:51:00.000000Z",
"updated_at": "2023-12-05T00:51:00.000000Z"
},
"items": [
{
"uuid": "68222706-82e4-4a30-a298-c64bd6240f99",
"item_description": "Freshfish",
"item_quantity": 1,
"item_value": "10000.00",
"created_at": "2023-12-05T00:51:00.000000Z"
}
]
},
{
"uuid": "b0febc7b-91a0-43d2-a933-fc1c27dd25c3",
"order_number": "531886487269",
"fleet_id": null,
"status": "In Transit",
"delivery_type": "state_to_state",
"sender_longitude": "3.3096414",
"sender_latitude": "6.5352628",
"customer_longitude": "7.4974495",
"customer_latitude": "9.0339358",
"delivery_fee": "NGN3,000.00",
"created_at": "2023-12-05T01:02:02.000000Z",
"customer_detail": {
"uuid": "caf911a3-7b66-4599-9b3a-aa26d7730e69",
"customer_name": "TundeNasri",
"customer_email": null,
"customer_phone_number": "08065302534",
"customer_phone_code": "234",
"customer_address": "12 Ahmadu Bello way, Central Business District, Abuja",
"created_at": "2023-12-04T22:03:06.000000Z"
},
"sender_detail": {
"uuid": "2743f3a5-b692-4c10-99f7-b3b941f0c3eb",
"sender_name": "Nuel Geek",
"sender_phone": "08087168391",
"sender_email": null,
"sender_phonecode": "234",
"sender_address": "2 Umuleri street, Lagos",
"created_at": "2023-12-05T01:02:02.000000Z",
"updated_at": "2023-12-06T00:45:41.000000Z"
},
"items": [
{
"uuid": "cbf13cbb-b817-42ce-b948-12344ff7507f",
"item_description": "Freshfish",
"item_quantity": 1,
"item_value": "10000.00",
"created_at": "2023-12-06T00:45:41.000000Z"
},
{
"uuid": "7cf6577f-c6e1-40fa-aa98-443ca27cdc3f",
"item_description": "Freshfish",
"item_quantity": 1,
"item_value": "10000.00",
"created_at": "2023-12-06T01:00:27.000000Z"
},
{
"uuid": "a758c1cb-011a-4f96-9f5e-249bff763e07",
"item_description": "Canno Camera",
"item_quantity": 1,
"item_value": "30000.00",
"created_at": "2023-12-06T01:00:54.000000Z"
},
{
"uuid": "a67c925e-c9bd-4829-ac2b-c429437f50e1",
"item_description": "Eva soap pack",
"item_quantity": 1,
"item_value": "4000.00",
"created_at": "2023-12-05T01:02:02.000000Z"
}
]
}
]
}
📝 Summary
This endpoint allows users to assign a delivery request to a specific rider. By providing the delivery ID and the driver’s information, the delivery request will be linked to the assigned personnel for processing and fulfillment. Once successfully assigned, the delivery status is updated accordingly.
📥 Requests
Path Parameters
Description:
| Field | Type | Required | Description |
|---|---|---|---|
rider_uuid | string | ✅ Yes |
Body
Description:
| Field | Type | Required | Description | ||
|---|---|---|---|---|---|
delivery_uuid[0] | string | ||||
delivery_uuid[1] | string |
📤 Response
✅ 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.customer_latitude | string | |||
data.customer_longitude | string | |||
data.delivery_fee | string | |||
data.delivery_type | string | |||
data.fleet_id | any / null | |||
data.items | object | |||
data.order_number | 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_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 | |||
status | string |
{
"status": "success",
"data": [
{
"uuid": "e207ecc7-dcab-439e-88e8-f3e630e53697",
"order_number": "387451602924",
"fleet_id": null,
"status": "Awaiting Pickup",
"delivery_type": "intra_state",
"sender_longitude": "7.3445666",
"sender_latitude": "8.95625",
"customer_longitude": "7.4974495",
"customer_latitude": "9.0339358",
"delivery_fee": "NGN3,000.00",
"created_at": "2023-12-05T00:51:00.000000Z",
"customer_detail": {
"uuid": "caf911a3-7b66-4599-9b3a-aa26d7730e69",
"customer_name": "TundeNasri",
"customer_email": null,
"customer_phone_number": "08065302534",
"customer_phone_code": "234",
"customer_address": "12 Ahmadu Bello way, Central Business District, Abuja",
"created_at": "2023-12-04T22:03:06.000000Z"
},
"sender_detail": {
"uuid": "cadb63c6-577b-4b30-ac6a-c4ca30884631",
"sender_name": "Nuel Geek",
"sender_phone": "08087168391",
"sender_email": null,
"sender_phonecode": "234",
"sender_address": "Aso housing estate, lugbe",
"created_at": "2023-12-05T00:51:00.000000Z",
"updated_at": "2023-12-05T00:51:00.000000Z"
},
"items": [
{
"uuid": "68222706-82e4-4a30-a298-c64bd6240f99",
"item_description": "Freshfish",
"item_quantity": 1,
"item_value": "10000.00",
"created_at": "2023-12-05T00:51:00.000000Z"
}
]
},
{
"uuid": "b0febc7b-91a0-43d2-a933-fc1c27dd25c3",
"order_number": "531886487269",
"fleet_id": null,
"status": "In Transit",
"delivery_type": "state_to_state",
"sender_longitude": "3.3096414",
"sender_latitude": "6.5352628",
"customer_longitude": "7.4974495",
"customer_latitude": "9.0339358",
"delivery_fee": "NGN3,000.00",
"created_at": "2023-12-05T01:02:02.000000Z",
"customer_detail": {
"uuid": "caf911a3-7b66-4599-9b3a-aa26d7730e69",
"customer_name": "TundeNasri",
"customer_email": null,
"customer_phone_number": "08065302534",
"customer_phone_code": "234",
"customer_address": "12 Ahmadu Bello way, Central Business District, Abuja",
"created_at": "2023-12-04T22:03:06.000000Z"
},
"sender_detail": {
"uuid": "2743f3a5-b692-4c10-99f7-b3b941f0c3eb",
"sender_name": "Nuel Geek",
"sender_phone": "08087168391",
"sender_email": null,
"sender_phonecode": "234",
"sender_address": "2 Umuleri street, Lagos",
"created_at": "2023-12-05T01:02:02.000000Z",
"updated_at": "2023-12-06T00:45:41.000000Z"
},
"items": [
{
"uuid": "cbf13cbb-b817-42ce-b948-12344ff7507f",
"item_description": "Freshfish",
"item_quantity": 1,
"item_value": "10000.00",
"created_at": "2023-12-06T00:45:41.000000Z"
},
{
"uuid": "7cf6577f-c6e1-40fa-aa98-443ca27cdc3f",
"item_description": "Freshfish",
"item_quantity": 1,
"item_value": "10000.00",
"created_at": "2023-12-06T01:00:27.000000Z"
},
{
"uuid": "a758c1cb-011a-4f96-9f5e-249bff763e07",
"item_description": "Canno Camera",
"item_quantity": 1,
"item_value": "30000.00",
"created_at": "2023-12-06T01:00:54.000000Z"
},
{
"uuid": "a67c925e-c9bd-4829-ac2b-c429437f50e1",
"item_description": "Eva soap pack",
"item_quantity": 1,
"item_value": "4000.00",
"created_at": "2023-12-05T01:02:02.000000Z"
}
]
}
]
}
curl --request POST \
--url https://dev.api.fleet.usedora.com/api/v1/deliveries/assign/%7B{rider_uuid}%7D{
"status": "success",
"data": [
{
"uuid": "e207ecc7-dcab-439e-88e8-f3e630e53697",
"order_number": "387451602924",
"fleet_id": null,
"status": "Awaiting Pickup",
"delivery_type": "intra_state",
"sender_longitude": "7.3445666",
"sender_latitude": "8.95625",
"customer_longitude": "7.4974495",
"customer_latitude": "9.0339358",
"delivery_fee": "NGN3,000.00",
"created_at": "2023-12-05T00:51:00.000000Z",
"customer_detail": {
"uuid": "caf911a3-7b66-4599-9b3a-aa26d7730e69",
"customer_name": "TundeNasri",
"customer_email": null,
"customer_phone_number": "08065302534",
"customer_phone_code": "234",
"customer_address": "12 Ahmadu Bello way, Central Business District, Abuja",
"created_at": "2023-12-04T22:03:06.000000Z"
},
"sender_detail": {
"uuid": "cadb63c6-577b-4b30-ac6a-c4ca30884631",
"sender_name": "Nuel Geek",
"sender_phone": "08087168391",
"sender_email": null,
"sender_phonecode": "234",
"sender_address": "Aso housing estate, lugbe",
"created_at": "2023-12-05T00:51:00.000000Z",
"updated_at": "2023-12-05T00:51:00.000000Z"
},
"items": [
{
"uuid": "68222706-82e4-4a30-a298-c64bd6240f99",
"item_description": "Freshfish",
"item_quantity": 1,
"item_value": "10000.00",
"created_at": "2023-12-05T00:51:00.000000Z"
}
]
},
{
"uuid": "b0febc7b-91a0-43d2-a933-fc1c27dd25c3",
"order_number": "531886487269",
"fleet_id": null,
"status": "In Transit",
"delivery_type": "state_to_state",
"sender_longitude": "3.3096414",
"sender_latitude": "6.5352628",
"customer_longitude": "7.4974495",
"customer_latitude": "9.0339358",
"delivery_fee": "NGN3,000.00",
"created_at": "2023-12-05T01:02:02.000000Z",
"customer_detail": {
"uuid": "caf911a3-7b66-4599-9b3a-aa26d7730e69",
"customer_name": "TundeNasri",
"customer_email": null,
"customer_phone_number": "08065302534",
"customer_phone_code": "234",
"customer_address": "12 Ahmadu Bello way, Central Business District, Abuja",
"created_at": "2023-12-04T22:03:06.000000Z"
},
"sender_detail": {
"uuid": "2743f3a5-b692-4c10-99f7-b3b941f0c3eb",
"sender_name": "Nuel Geek",
"sender_phone": "08087168391",
"sender_email": null,
"sender_phonecode": "234",
"sender_address": "2 Umuleri street, Lagos",
"created_at": "2023-12-05T01:02:02.000000Z",
"updated_at": "2023-12-06T00:45:41.000000Z"
},
"items": [
{
"uuid": "cbf13cbb-b817-42ce-b948-12344ff7507f",
"item_description": "Freshfish",
"item_quantity": 1,
"item_value": "10000.00",
"created_at": "2023-12-06T00:45:41.000000Z"
},
{
"uuid": "7cf6577f-c6e1-40fa-aa98-443ca27cdc3f",
"item_description": "Freshfish",
"item_quantity": 1,
"item_value": "10000.00",
"created_at": "2023-12-06T01:00:27.000000Z"
},
{
"uuid": "a758c1cb-011a-4f96-9f5e-249bff763e07",
"item_description": "Canno Camera",
"item_quantity": 1,
"item_value": "30000.00",
"created_at": "2023-12-06T01:00:54.000000Z"
},
{
"uuid": "a67c925e-c9bd-4829-ac2b-c429437f50e1",
"item_description": "Eva soap pack",
"item_quantity": 1,
"item_value": "4000.00",
"created_at": "2023-12-05T01:02:02.000000Z"
}
]
}
]
}