Get one delivery
GET /api/v1/deliveries/{deliveryId}
Authorization: Bearer sk_live_...Returns the same delivery object shape as create.
List deliveries
GET /api/v1/deliveries?limit=20&status=pending
Authorization: Bearer sk_live_...Query params:
| Param | Meaning |
|---|---|
limit |
1–50 (default 20) |
status |
Optional filter, e.g. pending |
cursor |
Pass the previous page's next_cursor |
Response includes deliveries and next_cursor (or null when finished).
Cancel a delivery
POST /api/v1/deliveries/{deliveryId}/cancel
Content-Type: application/json
Authorization: Bearer sk_live_...
{
"reason": "Customer changed their mind"
}Cancel is only allowed in certain statuses (same policy as the dashboard). If the rider already has the package, cancel will fail — tell the customer honestly.