Track Delivery Status
Track Delivery Status
GET
{baseUrl}/deliveries/track
Track the status and get details of a delivery using the batch ID or tracking ID
Query Parameters
Name
Type
Description
batchId
string
The batch ID of the delivery request
trackingId
string
The tracking ID of a specific delivery
Headers
Name
Type
Description
app_id*
String
app_secret*
String
{
"status": true,
"message": "Deliveries successfully retrieved",
"data": {
"id": "65fc04820686cd2854e20bf0",
"trackingUrl": "https://app.sendstack.africa/tracking?batchId=OLN9HI",
"paymentStatus": "PAID",
"paymentSource": "self",
"messageDropAfterPickup": false,
"batchId": "OLN9HI",
"initiator": "65fc04750686cd2854e20a92",
"isSameDayDelivery": false,
"hasLockerBooking": false,
"totalAmount": 1500,
"manager": {
"id": "65fc04750686cd2854e20a92",
"name": "Ginger Dibbert",
"email": "makayla_corwin15@gmail.com"
},
"pickup": {
"address": "8504 Collier Plaza",
"locationCode": "01",
"pickupName": "Karen Casper",
"pickupNumber": "+2348010988866",
"pickupDate": "2024-03-22T00:00:00.000Z",
"state": "Lagos",
"zone": "zone_1",
"lga": "Location 1",
"long": 3.345006,
"lat": 6.602928
},
"drops": [
{
"id": "65fc07e59d2de436cc08b56a",
"trips": [],
"processed": true,
//...truncated for brevity
}
],
"createdAt": "2024-03-21T09:57:22.070Z"
}
}
{
"status": false,
"message": "Delivery details not found",
"data": {}
}
Sample Success Data
// Sample Request Information
Url: https://sandbox.sendstack.africa/api/v1/deliveries/track?batchId={{batchId}}&trackingId={{trackingId}}
NB: Replace {{batchId}} and {{trackingId}} with their respective string values
Method: GET
Headers:
- app_id: "your app_id"
- app_secret: "your app_secret"
//Sample Response Body - 200 OK
{
"status": true,
"message": "Deliveries successfully retrieved",
"data": {
"id": "65fc04820686cd2854e20bf0",
"trackingUrl": "https://app.sendstack.africa/tracking?batchId=OLN9HI",
"paymentStatus": "PAID",
"paymentSource": "self",
"messageDropAfterPickup": false,
"batchId": "OLN9HI",
"initiator": "65fc04750686cd2854e20a92",
"isSameDayDelivery": false,
"hasLockerBooking": false,
"totalAmount": 1500,
"manager": {
"id": "65fc04750686cd2854e20a92",
"name": "Ginger Dibbert",
"email": "makayla_corwin15@gmail.com"
},
"pickup": {
"address": "8504 Collier Plaza",
"locationCode": "01",
"pickupName": "Karen Casper",
"pickupNumber": "+2348010988866",
"pickupDate": "2024-03-22T00:00:00.000Z",
"state": "Lagos",
"zone": "zone_1",
"lga": "Location 1",
"long": 3.345006,
"lat": 6.602928
},
"drops": [
{
"id": "65fc07e59d2de436cc08b56a",
"trips": [],
"processed": true,
//...truncated for brevity
}
],
"createdAt": "2024-03-21T09:57:22.070Z"
}
}
Sample Error Data
// Sample Request Information
Url: https://sandbox.sendstack.africa/api/v1/deliveries/track?batchId=invalidBatchId&trackingId=invalidTrackingId
Method: GET
Headers:
- app_id: "your app_id"
- app_secret: "your app_secret"
//Sample Response Body - 400 Bad Request
{
"status": false,
"message": "Invalid batchId or trackingId"
}
Last updated