Fetch Deliveries

Fetch Deliveries

GET {baseUrl}/deliveries

Fetch all deliveries you've made by passing your control business ID. You can also filter your deliveries by passing batchId as a query parameter. If no query parameter is passed along the request, it will fetch all deliveries under your control business ID.

NOTE: The value passed to "manager" should be your control business ID.

Query Parameters

Name	Type	Description
batchId	string	Batch Id generated for a delivery request
limit	number	The result limits for pagination, default is 15
page	number	page option for pagination, default is 1
manager*	String

Headers

Name	Type	Description
app_id*	String
app_secret*	String

200 Deliveries successfully retrieved.

{
     "status": true,
     "message": "Deliveries successfully retrieved",
     "data": {
        "results": [ 
          {
            "id": "65fbffcc98e73c14e499bb50",
            "trackingUrl": "https://app.sendstack.africa/tracking?batchId=4B12LN",
            "checkoutUrl": "https://checkout.paystack.com/g278qsf89ngt43d",
            "paymentStatus": "PENDING",
            "paymentSource": "08085632323",
            "batchId": "4B12LN",
            "totalAmount": "1500",
            "initiator": "65fbffc398e73c14e499bab4",
            "pickup": {
              "address": "95975 Barton Fields",
              "locationCode": "01",
              "pickupName": "Toni Dicki PhD",
              "pickupNumber": "[phone]",
              "pickupDate": "2024-03-22T00:00:00.000Z",
              "lga": "Location 1",
              "state": "Lagos"
            }
          }
         ],
        "page": 1,
        "limit": 10,
        "totalPages": 1,
        "totalResults": 1
      }
}

400: Bad Request Invalid control business ID

Sample Success Data

// Sample Request information
Url: https://sandbox.sendstack.africa/api/v1/deliveries?manager={{controlBusinessId}}
Method: GET
Headers: 
 - app_id: "your app_id"
 - app_secret: "your app_secret"
Query parameter:
 - manager = "controlBusinessId"

// Sample Response Body - 200 OK
{
    "status": true,
    "message": "Deliveries successfully retrieved",
    "data": {
        "drops": [
            {
                "id": "65b8c2c734d8cd1be099fd45",
                "deliveryId": "65b8c2c734d8cd1be099fd47",
                "status": "PENDING",
                "paymentStatus": "PENDING",
                "trackingId": "E033LM",
                "batchId": "T4SYZ3",
           }
           //...trunated for brevity
}

Filter By batchId

// Sample Request information
Url: https://sandbox.sendstack.africa/api/v1/deliveries?manager={{controlBusinessId}}&batchId={{batchId}}
Method: GET
Headers: 
 - app_id: "your app_id"
 - app_secret: "your app_secret"
Query parameter:
 - manager = "controlBusinessId"
 - batchId = "delivery batchId"

// Sample Response Body - 200 OK
{
    "status": true,
    "message": "Deliveries successfully retrieved",
    "data": {
        "drops": [
            {
                "id": "65b8c02734d8cd1be099fcf1",
                "status": "PENDING",
                "paymentStatus": "PENDING",
                "trackingId": "KH3I65",
                "batchId": "MFUD2A",
                "address": "95975 Barton Fields",
                "pickupName": "Toni Dicki PhD",
                "pickupNumber": "[phone]",
                "altPickupNumber": "[phone]",
                "pickupLga": "Yaba - Makoko",
                "pickupState": "Lagos",
                "recipientName": "Kabir",
                "recipientNumber": "[phone]",
                "recipientLga": "Yaba - Makoko",
                "amount": 1500,
                "estimatedPickupWindow": {
                    "date": "2024-10-27T08:00:00.000Z",
                    "start": "2024-10-27T08:00:00.000Z",
                    "end": "2024-10-27T13:00:00.000Z"
                },
                //...truncated for brevity
    }
}

Sample Error Data

// Sample Request information
Url: https://sandbox.sendstack.africa/api/v1/deliveries?manager=invalidControlBusinessId
Method: GET
Headers: 
 - app_id: "your app_id"
 - app_secret: "your app_secret"
Query parameter:
 - manager = "invalid controlBusinessId"

// Sample Response Body - 400 Bad Request
{
    "status": false,
    "message": "Invalid controlBusinessId"
}