> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usedora.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Get Deliveries
### 📝 Summary
This endpoint allows users to retrieve the details of a many deliveries by providing the unique delivery ID. It returns all relevant information related to the delivery, including the delivery status, sender and recipient details, assigned driver, and vehicle information.
***
### Requests
##### Example
```json theme={null}
{
"paginate": "{{paginate}}",
"per_page": "{{per_page}}",
"filter": "assigned_at",
"start_date": "2025-01-31",
"end_date": "2025-11-02",
"delivery_status": "pending",
"creation_mode": "manual",
"search": "prince",
"group_by": "receiver_city",
"tag_id": "8c57eac8-9eac-44da-a8bc-b0b7ac6aa385",
"scheduled": "true",
"schedule_date": "2025-06-18",
"search_all_locations": "true",
"partner_id": "",
"delivery_in_all_locations": "1",
"rider_id": "8c57eac8-9eac-44da-a8bc-b0b7ac6aa385"
}
```
##### Params
**Description:**
| Name | Location | Type | Required | Description | | | |
| --------------------------- | -------- | ------ | -------- | ----------------------------------------------------------------------------- | -------------- | ----------- | -------- |
| `paginate` | query | string | yes | can be 1 or 0 | | | |
| `per_page` | query | string | yes | none | | | |
| `filter` | query | string | yes | all, today, yesterday, created\_at, assigned\_at, dropoff\_at, schedule\_date | | | |
| `start_date` | query | string | yes | none | | | |
| `end_date` | query | string | yes | none | | | |
| `delivery_status` | query | string | yes | pending, awaiting\_pickup, in\_transit,delivered, cancelled, declined | | | |
| `creation_mode` | query | string | no | automated | manual | via booking | imported |
| `search` | query | string | no | none | | | |
| `group_by` | query | string | no | sender\_city | receiver\_city | | |
| `tag_id` | query | string | no | none | | | |
| `scheduled` | query | string | no | none | | | |
| `schedule_date` | query | string | no | none | | | |
| `search_all_locations` | query | string | no | boolean | | | |
| `partner_id` | query | string | no | none | | | |
| `delivery_in_all_locations` | query | string | no | none | | | |
| `rider_id` | query | string | yes | none | | | |
### Responses
| HTTP Status Code | Meaning | Description | Data schema |
| -------------------------------- | ---------------------------------------------------------------- | ----------- | ----------- |
| 200 | [OK](https://tools.ietf.org/html/rfc7231#section-6.3.1) | none | Inline |
| 422 | [Bad Request](https://tools.ietf.org/html/rfc7231#section-6.3.1) | none | Inline |
```json sample response theme={null}
{
"message": "Deliveries retrieved successfully!",
"data": {
"delivery_counts": {
"overall_user_awaiting_pickup_deliveries": 1,
"overall_user_in_transit_deliveries": 0,
"overall_user_delivered_deliveries": 0,
"overall_user_cancelled_deliveries": 0
},
"deliveries": {
"current_page": 1,
"data": [
{
"uuid": "4224a405-15c6-4579-9733-12620450d45c",
"order_number": "021393049",
"status": "Awaiting Pickup",
"created_at": "2023-10-28T16:57:53.000000Z",
"customer_detail": {
"id": "8ddf85e3-436a-47f9-a9ec-5113cdb19979",
"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-29T00:50:58.000000Z"
},
"delivery_detail": {
"uuid": "b94aff30-ebe0-4439-a82d-a173773d78b5",
"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-29T00:50:58.000000Z",
"updated_at": "2023-10-29T00:50:58.000000Z"
},
"items": [
{
"uuid": "416dbe29-434f-4cb6-bed5-ce7183176b8d",
"item_description": "Freshfish",
"item_quantity": 1,
"item_weight": "10.00",
"item_value": "10000.00",
"created_at": "2023-10-28T22:08:57.000000Z"
},
{
"uuid": "4ae72c0f-7fc7-4dfa-9d7e-6eebefb84c1a",
"item_description": "Freshfish",
"item_quantity": 1,
"item_weight": "10.00",
"item_value": "10000.00",
"created_at": "2023-10-28T22:11:42.000000Z"
},
{
"uuid": "e37d909e-a3f9-4443-9912-9c2befdf23db",
"item_description": "Freshfish",
"item_quantity": 1,
"item_weight": "10.00",
"item_value": "10000.00",
"created_at": "2023-10-29T00:50:59.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"
}
}
],
"first_page_url": "http://localhost:8000/api/deliveries?page=1",
"from": 1,
"last_page": 1,
"last_page_url": "http://localhost:8000/api/deliveries?page=1",
"links": [
{
"url": null,
"label": "« Previous",
"active": false
},
{
"url": "http://localhost:8000/api/deliveries?page=1",
"label": "1",
"active": true
},
{
"url": null,
"label": "Next »",
"active": false
}
],
"next_page_url": null,
"path": "http://localhost:8000/api/deliveries",
"per_page": 10,
"prev_page_url": null,
"to": 1,
"total": 1
}
},
"status": "success"
}
```