DELIVERIES
List deliveries
roadrunnerzw.com/api/v1/deliveries
Returns your deliveries, newest first. Filter with status (repeatable),
client_reference, created_after and created_before. Paging is by
cursor: pass the next_cursor from the previous page.
curl -X GET https://roadrunnerzw.com/api/v1/deliveries \
-H 'Authorization: Bearer rr_live_your_key_id' \
-H 'X-RR-Timestamp: $(date +%s)' \
-H 'X-RR-Signature: $SIGNATURE'
{
"object": "list",
"data": [
{
"id": "dlv_01JAV3K2QX8M4N7P",
"object": "delivery",
"client_reference": "ABC-10432",
"status": "dispatched",
"test_mode": false,
"pickup": {
"name": "ABC",
"phone": "+263242000000",
"address": "10 Example Avenue, Harare, Zimbabwe",
"instructions": "Collect from the front counter"
},
"dropoff": {
"name": "John Doe",
"phone": "+263770000000",
"email": "john@example.com",
"address": "45 Example Road, Harare, Zimbabwe",
"instructions": "Gate code 4471. Call on arrival."
},
"items": [
{
"name": "Widget, large",
"quantity": 2,
"unit_price": 1250,
"notes": "Handle with care"
}
],
"payment_type": "prepaid",
"cash_to_collect": null,
"pricing": {
"subtotal": {
"amount": 2500,
"currency": "USD"
},
"delivery_fee": {
"amount": 500,
"currency": "USD"
},
"tax": {
"amount": 0,
"currency": "USD"
},
"total": {
"amount": 3000,
"currency": "USD"
}
},
"scheduled_for": null,
"tracking_url": "https://staging.roadrunnerzw.com/t/8f2a9c1e4b",
"courier": null,
"eta": null,
"proof_of_delivery": null,
"created_at": "2026-09-21T14:30:00+02:00",
"updated_at": "2026-09-21T14:30:06+02:00",
"dispatched_at": "2026-09-21T14:30:06+02:00",
"delivered_at": null,
"cancelled_at": null,
"cancellation_reason": null
}
],
"has_more": false,
"next_cursor": null
}
Responses
200 OK
A cursor-paginated page of your deliveries, newest first.
401 Unauthenticated
The signature, key or timestamp did not check out. Also returned for a revoked key, and for a timestamp more than 300 seconds from ours.
403 Forbidden
The key is valid but was not issued the scope this endpoint requires. Scopes are fixed at issue, so this needs a new key rather than a retry.
429 Too many requests
Too many requests for this client. Back off and retry; the response carries Retry-After and X-RateLimit-* headers.