Skip to content
StraventaDocs
Now in Sandbox.

The seller's own-delivery dispatch board

GET
/v1/marketplace/deliveries

The queue a dispatcher works, ordered by the window each delivery must leave for — not by when the order was placed, which says nothing about when a rider must go. pod_url is a FIVE-MINUTE PRESIGNED URL and is "" when there is no proof-of-delivery photo. It is never a permanent public URL: the photograph shows a buyer's front door. driver_phone and recipient_name are on THIS payload and never on a buyer one. The dispatcher telephoning their own rider is the point of the board; the buyer contacts the shop. Permission marketplace.order.read.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Query Parameters

store_id*string

The store whose board is read.

Formatuuid
date?string

One calendar day in the STORE's timezone, YYYY-MM-DD. A bare date rather than an instant, so a dispatcher cannot filter by another zone's day boundary.

Formatdate
status?string

One dispatch status. An unrecognised value is refused rather than passed through, because an empty page reads to a dispatcher as "no deliveries" rather than as "you typed something wrong".

Value in"scheduled" | "assigned" | "out_for_delivery" | "delivered" | "failed" | "cancelled"
page?integer

1-based page number.

Default1
Range1 <= value
limit?integer

Page size, capped at 100.

Default25
Range1 <= value <= 100

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://sandbox.505pay.link/v1/marketplace/deliveries?store_id=497f6eca-6276-4993-bfeb-53cbbbba6f08"
{
  "items": [
    {
      "id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
      "order_id": "3f1a2b4c-5d6e-4f70-8192-a3b4c5d6e7f8",
      "order_number": "ORD-20260922-0007",
      "slot_starts_at": "2026-09-22T03:00:00Z",
      "slot_ends_at": "2026-09-22T05:00:00Z",
      "area_code": "31.71.01.1001",
      "distance_km": 4.2,
      "driver_name": "Budi",
      "driver_phone": "0812-3456-7890",
      "status": "out_for_delivery",
      "attempt": 1,
      "failure_reason": "",
      "recipient_name": "",
      "pod_url": "",
      "dispatched_at": "2026-09-22T02:40:00Z"
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 25
}
{
  "error": "not_found",
  "message": "resource not found",
  "request_id": "01916b2a-f3c0-7000-0000-0000000000ff"
}
{
  "error": "not_found",
  "message": "resource not found",
  "request_id": "01916b2a-f3c0-7000-0000-0000000000ff"
}
{
  "error": "not_found",
  "message": "resource not found",
  "request_id": "01916b2a-f3c0-7000-0000-0000000000ff"
}
{
  "error": "not_found",
  "message": "resource not found",
  "request_id": "01916b2a-f3c0-7000-0000-0000000000ff"
}

Was this page helpful?