Get Deliveries
curl --request GET \
--url https://dev.api.fleets.usedora.com/api/v1/deliveriesimport requests
url = "https://dev.api.fleets.usedora.com/api/v1/deliveries"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://dev.api.fleets.usedora.com/api/v1/deliveries', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://dev.api.fleets.usedora.com/api/v1/deliveries",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://dev.api.fleets.usedora.com/api/v1/deliveries"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://dev.api.fleets.usedora.com/api/v1/deliveries")
.asString();require 'uri'
require 'net/http'
url = URI("https://dev.api.fleets.usedora.com/api/v1/deliveries")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"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"
}
Manage Deliveries
Get Deliveries
Get Deliveries
curl --request GET \
--url https://dev.api.fleets.usedora.com/api/v1/deliveriesimport requests
url = "https://dev.api.fleets.usedora.com/api/v1/deliveries"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://dev.api.fleets.usedora.com/api/v1/deliveries', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://dev.api.fleets.usedora.com/api/v1/deliveries",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://dev.api.fleets.usedora.com/api/v1/deliveries"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://dev.api.fleets.usedora.com/api/v1/deliveries")
.asString();require 'uri'
require 'net/http'
url = URI("https://dev.api.fleets.usedora.com/api/v1/deliveries")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"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"
}
📝 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
Show child attributes
Show child attributes
{
"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
Show child attributes
Show child attributes
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 | none | Inline |
| 422 | Bad Request | none | Inline |
{
"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"
}
⌘I