Manage Riders
Rider Delivery History
REST API Documentation
Manage Riders
Rider Delivery History
curl --request GET \
--url https://dev.api.fleet.usedora.com/api/v1/riders/delivery/history
{
"status": "success",
"data": {
"current_page": 1,
"data": [
{
"uuid": "4560f59a-d071-4854-a098-2978ba373004",
"order_number": "14192541",
"fleet_identity_number": "68316349",
"status": "Awaiting-Pickup",
"delivery_type": "intra_state",
"sender_longitude": null,
"sender_latitude": null,
"customer_longitude": null,
"customer_latitude": null,
"delivery_fee": "3000",
"currency": "NGN",
"note": null,
"creation_mode": "Manual",
"created_at": "2024-01-06T17:02:09.000000Z",
"customer_detail": {
"uuid": "21803e28-08b7-4b23-b3f6-49161f8a6a4c",
"customer_name": "TundeNasri",
"customer_email": "sinoma@gmail.com",
"customer_phone_number": "08065302534",
"customer_phone_code": "234",
"customer_address": "12 Ahmadu Bello way, Central Business District, Abuja",
"created_at": "2024-01-06T07:28:13.000000Z"
},
"sender_detail": {
"uuid": "62c70575-366c-44c3-893e-504abce1f667",
"sender_name": "Nuel Geek",
"sender_phone": "08087168391",
"sender_email": "sender@example.com",
"sender_phonecode": "234",
"sender_address": "2 Umuleri street, Lagos",
"created_at": "2024-01-06T17:02:09.000000Z",
"updated_at": "2024-01-06T17:03:26.000000Z"
},
"items": [
{
"uuid": "99594223-8c39-49be-aefb-a1704e2e2650",
"item_description": "Packaged makeup for mama emma's birthday celebration",
"item_quantity": 2,
"item_value": "43500.00",
"currency": "NGN",
"created_at": "2024-01-06T17:02:09.000000Z"
},
{
"uuid": "801f2638-4a26-444d-9409-c5f54667e449",
"item_description": "Eva soap pack",
"item_quantity": 1,
"item_value": "4000.00",
"currency": "NGN",
"created_at": "2024-01-06T17:03:26.000000Z"
},
{
"uuid": "68751dcf-4440-4b51-9dbc-9e161b21ce2b",
"item_description": "Cannon Camera",
"item_quantity": 1,
"item_value": "30000.00",
"currency": "NGN",
"created_at": "2024-01-06T17:03:26.000000Z"
}
],
"rider_info": {
"uuid": "69234d24-61c1-4d68-a232-7a04d71f2b0e",
"riderid": "71762164",
"name": "Kelly Chimaobi",
"address": "Aso housing estate, lugbe",
"phone_number": "07081131771",
"phone_code": "234",
"email": "kyl@gmail.com",
"vehicle_plate_number": "Ae93480G",
"photo": "https://usedora-bucket-dev.s3.amazonaws.com/photos/S97Eie0RU6bdafmq5OjV9HeZkuCYdL0UNaT4SP52.jpg",
"total_completed_delivery": 0,
"active": false,
"number_of_ongoing_deliveries": 0,
"total_revenue_by_rider": "0",
"rider_ongoing_deliveries": null,
"created_at": "2024-01-06T08:02:20.000000Z"
}
}
],
"first_page_url": "http://127.0.0.1:8000/api/riders/delivery_history/69234d24-61c1-4d68-a232-7a04d71f2b0e?page=1",
"from": 1,
"last_page": 1,
"last_page_url": "http://127.0.0.1:8000/api/riders/delivery_history/69234d24-61c1-4d68-a232-7a04d71f2b0e?page=1",
"links": [
{
"url": null,
"label": "« Previous",
"active": false
},
{
"url": "http://127.0.0.1:8000/api/riders/delivery_history/69234d24-61c1-4d68-a232-7a04d71f2b0e?page=1",
"label": "1",
"active": true
},
{
"url": null,
"label": "Next »",
"active": false
}
],
"next_page_url": null,
"path": "http://127.0.0.1:8000/api/riders/delivery_history/69234d24-61c1-4d68-a232-7a04d71f2b0e",
"per_page": 5,
"prev_page_url": null,
"to": 1,
"total": 1
}
}
📝 Summary
This endpoint retrieves the delivery history of a specific rider, including details about the deliveries they have completed, their status, and relevant timestamps. The history can be filtered by date, status, and other optional parameters.
📥 Requests
Path Parameters
Description:
Field | Type | Required | Description |
---|---|---|---|
rider_uuid | string | ✅ Yes |
Query Parameters
Description: multipart/form-data
Field | Type | Required | Description | ||
---|---|---|---|---|---|
paginate | string | ||||
per_page | string |
📤 Response
✅ 200 OK
❌ 422 Bad Request
Description:
Field | Type | Required | Description | |
---|---|---|---|---|
data | object | |||
current_page | number | |||
data.data | object | |||
data.data.created_at | string | |||
data.data.creation_mode | string | |||
data..data.currency | string | |||
data.data.customer_detail | object | |||
data.data.customer_detail.created_at | string | |||
data.data.customer_detail.customer_address | string | |||
data.data.customer_detail.customer_email | string | |||
data.data.customer_detail.customer_name | string | |||
data.data.customer_detail.customer_phone_code | string | |||
data.data.customer_detail.customer_phone_number | string | |||
data.data.customer_detail.uuid | string | |||
data.data.customer_latitude | any / null | |||
data.data.customer_longitude | any / null | |||
data.data.delivery_type | string | |||
data.data.fleet_identity_number | string | |||
data.data.items | object | |||
data.data.items.created_at | string | |||
data.data.items.currency | string | |||
data.data.items.item_description | string | |||
data.data.items.item_quantity | number | |||
data.data.items.item_value | string | |||
data.data.items.uuid | string | |||
data.data.note | string | |||
data.data.order_number | string | |||
data.data.rider_info | object | |||
data.data.rider_info.active | boolean | |||
data.data.rider_info.address | string | |||
data.data.rider_info.created_at | string | |||
data.data.rider_info.email | string | |||
data.data.rider_info.name | string | |||
data.data.rider_info.number_of_ongoing_deliveries | number | |||
data.data.rider_info.phone_code | string | |||
data.data.rider_info.phone_number | string | |||
data.data.rider_info.photo | string | |||
data.data.rider_info.rider_ongoing_deliveries | any / null | |||
data.data.rider_info.riderid | string | |||
data.data.rider_info.total_completed_delivery | number | |||
data.data.rider_info.total_revenue_by_rider | string | |||
data.data.rider_info.uuid | string | |||
data.data.rider_info.vehicle_plate_number | string | |||
data.data.sender_detail | object | |||
data.data.delivery_fee | string | |||
data.data.delivery_fee | string | |||
data.data.delivery_fee | string | |||
data.data.delivery_fee | string | |||
data.data.delivery_fee | string | |||
data.data.delivery_fee | string | |||
data.data.delivery_fee | string | |||
data.data.delivery_fee | string | |||
data.data.delivery_fee | string | |||
data.data.delivery_fee | string | |||
data.data.delivery_fee | string | |||
data.data.delivery_fee | string | |||
data.data.delivery_fee | string | |||
data.data.delivery_fee | string | |||
data.data.delivery_fee | string | |||
data.data.delivery_fee | string | |||
data.data.sender_detail.created_at | string | |||
data.data.sender_detail.sender_address | string | |||
data.data.sender_detail.sender_email | any / null | |||
data.data.sender_detail.sender_phonecode | string | |||
data.data.sender_detail.updated_at | string | |||
data.data.sender_detail.uuid | string | |||
data.data.sender_latitude | string | |||
data.data.sender_longitude | string | |||
data.data.status | string | |||
data.data.uuid | string | |||
data.first_page_url | string | |||
data.from | number | |||
data.last_page_url | string | |||
data.links | object | |||
data.links.active | boolean | |||
data.links.label | string | |||
data.links.url | string / null | |||
data.next_page_url | any / null | |||
data_path | string | |||
data.per_page | number | |||
data.prev_page_url | any / null | |||
data.to | number | |||
data.total | number | |||
status | string |
{
"status": "success",
"data": {
"current_page": 1,
"data": [
{
"uuid": "4560f59a-d071-4854-a098-2978ba373004",
"order_number": "14192541",
"fleet_identity_number": "68316349",
"status": "Awaiting-Pickup",
"delivery_type": "intra_state",
"sender_longitude": null,
"sender_latitude": null,
"customer_longitude": null,
"customer_latitude": null,
"delivery_fee": "3000",
"currency": "NGN",
"note": null,
"creation_mode": "Manual",
"created_at": "2024-01-06T17:02:09.000000Z",
"customer_detail": {
"uuid": "21803e28-08b7-4b23-b3f6-49161f8a6a4c",
"customer_name": "TundeNasri",
"customer_email": "sinoma@gmail.com",
"customer_phone_number": "08065302534",
"customer_phone_code": "234",
"customer_address": "12 Ahmadu Bello way, Central Business District, Abuja",
"created_at": "2024-01-06T07:28:13.000000Z"
},
"sender_detail": {
"uuid": "62c70575-366c-44c3-893e-504abce1f667",
"sender_name": "Nuel Geek",
"sender_phone": "08087168391",
"sender_email": "sender@example.com",
"sender_phonecode": "234",
"sender_address": "2 Umuleri street, Lagos",
"created_at": "2024-01-06T17:02:09.000000Z",
"updated_at": "2024-01-06T17:03:26.000000Z"
},
"items": [
{
"uuid": "99594223-8c39-49be-aefb-a1704e2e2650",
"item_description": "Packaged makeup for mama emma's birthday celebration",
"item_quantity": 2,
"item_value": "43500.00",
"currency": "NGN",
"created_at": "2024-01-06T17:02:09.000000Z"
},
{
"uuid": "801f2638-4a26-444d-9409-c5f54667e449",
"item_description": "Eva soap pack",
"item_quantity": 1,
"item_value": "4000.00",
"currency": "NGN",
"created_at": "2024-01-06T17:03:26.000000Z"
},
{
"uuid": "68751dcf-4440-4b51-9dbc-9e161b21ce2b",
"item_description": "Cannon Camera",
"item_quantity": 1,
"item_value": "30000.00",
"currency": "NGN",
"created_at": "2024-01-06T17:03:26.000000Z"
}
],
"rider_info": {
"uuid": "69234d24-61c1-4d68-a232-7a04d71f2b0e",
"riderid": "71762164",
"name": "Kelly Chimaobi",
"address": "Aso housing estate, lugbe",
"phone_number": "07081131771",
"phone_code": "234",
"email": "kyl@gmail.com",
"vehicle_plate_number": "Ae93480G",
"photo": "https://usedora-bucket-dev.s3.amazonaws.com/photos/S97Eie0RU6bdafmq5OjV9HeZkuCYdL0UNaT4SP52.jpg",
"total_completed_delivery": 0,
"active": false,
"number_of_ongoing_deliveries": 0,
"total_revenue_by_rider": "0",
"rider_ongoing_deliveries": null,
"created_at": "2024-01-06T08:02:20.000000Z"
}
}
],
"first_page_url": "http://127.0.0.1:8000/api/riders/delivery_history/69234d24-61c1-4d68-a232-7a04d71f2b0e?page=1",
"from": 1,
"last_page": 1,
"last_page_url": "http://127.0.0.1:8000/api/riders/delivery_history/69234d24-61c1-4d68-a232-7a04d71f2b0e?page=1",
"links": [
{
"url": null,
"label": "« Previous",
"active": false
},
{
"url": "http://127.0.0.1:8000/api/riders/delivery_history/69234d24-61c1-4d68-a232-7a04d71f2b0e?page=1",
"label": "1",
"active": true
},
{
"url": null,
"label": "Next »",
"active": false
}
],
"next_page_url": null,
"path": "http://127.0.0.1:8000/api/riders/delivery_history/69234d24-61c1-4d68-a232-7a04d71f2b0e",
"per_page": 5,
"prev_page_url": null,
"to": 1,
"total": 1
}
}
curl --request GET \
--url https://dev.api.fleet.usedora.com/api/v1/riders/delivery/history
{
"status": "success",
"data": {
"current_page": 1,
"data": [
{
"uuid": "4560f59a-d071-4854-a098-2978ba373004",
"order_number": "14192541",
"fleet_identity_number": "68316349",
"status": "Awaiting-Pickup",
"delivery_type": "intra_state",
"sender_longitude": null,
"sender_latitude": null,
"customer_longitude": null,
"customer_latitude": null,
"delivery_fee": "3000",
"currency": "NGN",
"note": null,
"creation_mode": "Manual",
"created_at": "2024-01-06T17:02:09.000000Z",
"customer_detail": {
"uuid": "21803e28-08b7-4b23-b3f6-49161f8a6a4c",
"customer_name": "TundeNasri",
"customer_email": "sinoma@gmail.com",
"customer_phone_number": "08065302534",
"customer_phone_code": "234",
"customer_address": "12 Ahmadu Bello way, Central Business District, Abuja",
"created_at": "2024-01-06T07:28:13.000000Z"
},
"sender_detail": {
"uuid": "62c70575-366c-44c3-893e-504abce1f667",
"sender_name": "Nuel Geek",
"sender_phone": "08087168391",
"sender_email": "sender@example.com",
"sender_phonecode": "234",
"sender_address": "2 Umuleri street, Lagos",
"created_at": "2024-01-06T17:02:09.000000Z",
"updated_at": "2024-01-06T17:03:26.000000Z"
},
"items": [
{
"uuid": "99594223-8c39-49be-aefb-a1704e2e2650",
"item_description": "Packaged makeup for mama emma's birthday celebration",
"item_quantity": 2,
"item_value": "43500.00",
"currency": "NGN",
"created_at": "2024-01-06T17:02:09.000000Z"
},
{
"uuid": "801f2638-4a26-444d-9409-c5f54667e449",
"item_description": "Eva soap pack",
"item_quantity": 1,
"item_value": "4000.00",
"currency": "NGN",
"created_at": "2024-01-06T17:03:26.000000Z"
},
{
"uuid": "68751dcf-4440-4b51-9dbc-9e161b21ce2b",
"item_description": "Cannon Camera",
"item_quantity": 1,
"item_value": "30000.00",
"currency": "NGN",
"created_at": "2024-01-06T17:03:26.000000Z"
}
],
"rider_info": {
"uuid": "69234d24-61c1-4d68-a232-7a04d71f2b0e",
"riderid": "71762164",
"name": "Kelly Chimaobi",
"address": "Aso housing estate, lugbe",
"phone_number": "07081131771",
"phone_code": "234",
"email": "kyl@gmail.com",
"vehicle_plate_number": "Ae93480G",
"photo": "https://usedora-bucket-dev.s3.amazonaws.com/photos/S97Eie0RU6bdafmq5OjV9HeZkuCYdL0UNaT4SP52.jpg",
"total_completed_delivery": 0,
"active": false,
"number_of_ongoing_deliveries": 0,
"total_revenue_by_rider": "0",
"rider_ongoing_deliveries": null,
"created_at": "2024-01-06T08:02:20.000000Z"
}
}
],
"first_page_url": "http://127.0.0.1:8000/api/riders/delivery_history/69234d24-61c1-4d68-a232-7a04d71f2b0e?page=1",
"from": 1,
"last_page": 1,
"last_page_url": "http://127.0.0.1:8000/api/riders/delivery_history/69234d24-61c1-4d68-a232-7a04d71f2b0e?page=1",
"links": [
{
"url": null,
"label": "« Previous",
"active": false
},
{
"url": "http://127.0.0.1:8000/api/riders/delivery_history/69234d24-61c1-4d68-a232-7a04d71f2b0e?page=1",
"label": "1",
"active": true
},
{
"url": null,
"label": "Next »",
"active": false
}
],
"next_page_url": null,
"path": "http://127.0.0.1:8000/api/riders/delivery_history/69234d24-61c1-4d68-a232-7a04d71f2b0e",
"per_page": 5,
"prev_page_url": null,
"to": 1,
"total": 1
}
}