Get delivery details

Returns the current state of an in-progress or completed delivery — status, courier, quote, timeline history, and POD media.

GET/express/v1/deliveries/{deliveryID}

The legacy path GET /v1/deliveries/{deliveryID} is deprecated (21 May 2026) and will be obsoleted on 21 November 2026. New integrations must use GET /express/v1/deliveries/{deliveryID}.

Headers

Authorizationstringrequired

Bearer token.

Parameters

deliveryIDstringrequired

Path parameter. The Dash-issued id from Create Delivery, e.g. DEL-EXP-20260805-0001.

This response carries the same status vocabulary and courier / media / failure fields as the v2 webhook payload. Poll it to recover state after a missed webhook — but treat webhooks as the primary channel; polling won't tell you about transitions you slept through.

Response envelope

Every successful response is wrapped in a common envelope:

statusstringalways

"Success" on a 200 OK.

messagestringalways

Human-readable result message.

requestIdstringalways

Echo of the request trace ID.

meta.requestIDstringalways

Same as requestId.

meta.timestampdatetimealways

Server time the response was generated.

dataobjectalways

The delivery payload — see fields below.

Response fields

deliveryIDstringalways

Dash-issued delivery id.

providerOrderIDstringalways

Your AWB / order reference, echoed from Create Delivery.

paymentMethodstringalways

CASHLESS, COD, CASH, or QRIS.

statusstringalways

Current status. Same vocabulary as the webhook — see Status reference. Includes checkpoint statuses ARRIVED_AT_PICKUP_POINT / ARRIVED_AT_DESTINATION, return statuses PENDING_RETURN / IN_RETURN / FAILED_IN_RETURN / ON_HOLD / RETURNED, the write-off status DISPOSED, and failure statuses FAILED_PICKUP / FAILED_DELIVERY / FAILED.

invoiceNostringnullable

Internal invoice reference number.

trackingURLstringnullable

Live-tracking URL. Present in live mode; null in sandbox.

courierobjectnullable

Driver info. Null until a driver is assigned. Replaced wholesale on reassignment.

courier.namestringnullable

Driver display name.

courier.phonestringnullable

Driver phone number.

courier.vehiclePlateNumberstringnullable

Driver's vehicle plate. Sourced from metadata; falls back to bikeLicensePlate.

courier.profileImageUrlstringnullable

URL of the driver's profile photo. null for a driver with no photo on file — render a fallback rather than a broken image.

media[]arrayalways

POD entries. Each item has type, url, and createdAt. Empty until the first proof is captured. See Media types below.

timeline[]arrayalways

Ordered status history. Each entry contains status, createdAt, created_at (formatted), notes, and reasonCode.

quoteobjectalways

Service, pricing, distance, estimated timeline, origin/destination, and package rows.

quote.serviceobjectalways

category, type, and name of the service.

quote.currencyobjectalways

code and symbol, e.g. IDR / Rp.

quote.amountnumberalways

Fare in the smallest currency unit.

quote.distancenumberalways

Route distance in metres.

quote.estimatedTimelineobjectalways

pickup and dropoff estimated timestamps (ISO 8601).

quote.originobjectalways

Pickup location: address, coordinates (latitude, longitude), and notes.

quote.destinationobjectalways

Drop-off location: address, coordinates, and notes.

quote.packages[]arrayalways

Package rows as submitted. Each row has name, type, description, quantity, weight, length, width, height (dimensions null if not provided). type is one of REGULAR, SPECIAL, SENSITIVE, HIGH_VALUE, OTHER — REGULAR when it wasn't set on create. Deliveries created before type was introduced return null.

senderobjectalways

Sender contact block, echoed.

sender.firstNamestringalways

sender.lastNamestringnullable

sender.companyNamestringnullable

sender.phonestringalways

recipientobjectalways

Recipient contact block, echoed.

recipient.firstNamestringalways

recipient.lastNamestringnullable

recipient.companyNamestringnullable

recipient.emailstringnullable

recipient.phonestringalways

recipient.actualRecipientNamestringnullable

Who actually signed for the package. Populated on COMPLETED — and on RETURNED, where it describes whoever accepted the return.

recipient.actualRecipientRelationstringnullable

Relation of the signer to the intended recipient, e.g. "spouse". Populated alongside actualRecipientName.

instructions[]arrayalways

Delivery instructions. Each entry has text, type (e.g. NOTE), and url.

advanceInfoobjectnullable

Failure detail object. Present on FAILED_PICKUP / FAILED_DELIVERY / FAILED and CANCELLED — contains failedReason string. null otherwise, including on FAILED_IN_RETURN — read that failure's reason from its timelines[] entry instead.

cashOnDeliveryobjectnullable

COD detail object. Contains amount when payment method involves cash collection. null otherwise.

additionalInfoanynullable

Reserved for future use. Currently null.

createdAtdatetimealways

When the delivery was created.

updatedAtdatetimealways

When the delivery record was last modified.

pickupAtdatetimenullable

When the driver collected the package. null before pickup and on FAILED_PICKUP.

completedAtdatetimenullable

Set on COMPLETED or RETURNED; empty string / null otherwise.

pickup_sla_statusstringalways

"On Time", "Late", or "Waiting" — SLA status of the pickup leg.

complete_sla_statusstringalways

"On Time", "Late", or "Waiting" — SLA status of the delivery leg.

delay_duration_minutesnumberalways

Total delay in minutes relative to the estimated timeline. 0 when on time.

Media types

PICKUP_PROOF

Photo captured by the driver at pickup. Present from PENDING_DELIVERY onward (EXPRESS only).

DELIVERY_PROOF

Handover photo. Present once status reaches COMPLETED.

FAILED_PICKUP_PROOF

Photo captured when the pickup leg failed. Present on FAILED_PICKUP (EXPRESS) or a pickup-phase FAILED (LOGISTIC).

FAILED_DELIVERY_PROOF

Photo captured when the delivery leg failed. Present on FAILED_DELIVERY (EXPRESS) or a delivery-phase FAILED (LOGISTIC).

FAILED_PROOF

Generic failure proof used when a single FAILED status is reported (LOGISTIC path or legacy).

FAILED_RETURN_PROOF

Photo captured when the return leg failed — the driver could not hand the package back. Present on FAILED_IN_RETURN.

RETURN_PROOF

Photo captured when the package was handed back to the sender. Present on RETURNED.

Changed in v2. The single FAILED_PROOF media type has been split into FAILED_PICKUP_PROOF / FAILED_DELIVERY_PROOF on the EXPRESS path. If you match on media type to render POD galleries, update that list.

State-by-state reference

State	`status`	`advanceInfo`	`recipient.actualRecipient*`	`completedAt`	Typical `media[].type`
In Progress	`IN_DELIVERY`	`null`	`null` / `null`	`""`	(empty)
Completed	`COMPLETED`	`null`	populated	timestamp	`DELIVERY_PROOF`
Failed	`FAILED`	`{ failedReason }`	`null` / `null`	`""`	`FAILED_PROOF`
Failed return	`FAILED_IN_RETURN`	`null`	`null` / `null`	`""`	`FAILED_RETURN_PROOF`
On hold	`ON_HOLD`	`null`	`null` / `null`	`""`	(carried over from the failed return)
Returned	`RETURNED`	`null`	populated	`""`	`RETURN_PROOF`
Disposed	`DISPOSED`	`null`	`null` / `null`	`""`	(carried over; no disposal proof type)

Error responses

404Pengantaran tidak ditemukan. — deliveryID doesn't exist for your workspace.

Request

curl https://api.dashelectric.co/express/v1/deliveries/DEL-EXP-20260805-0001 \
  -H "Authorization: Bearer $DASH_TOKEN"

Response 200 OK

In flight
Completed
Failed
Returned

{
  "status": "Success",
  "message": "Data fetched successfully",
  "requestId": "req-8f3a21",
  "meta": {
    "requestID": "req-8f3a21",
    "timestamp": "2026-08-05T11:32:44+07:00"
  },
  "data": {
    "deliveryID": "DEL-EXP-20260805-0001",
    "providerOrderID": "PO-99120",
    "paymentMethod": "CASH",
    "status": "IN_DELIVERY",
    "invoiceNo": "INV-2026-0811",
    "trackingURL": "https://track.dashelectric.id/live/trk_9f8e7d6c",
    "courier": {
      "name": "Budi Santoso",
      "phone": "+628111222333",
      "profileImageUrl": "https://storage.googleapis.com/driver-media/selfies/99.jpg",
      "vehiclePlateNumber": "B 1234 XYZ"
    },
    "media": [],
    "timeline": [
      { "status": "PENDING_PICKUP", "created_at": "2026-08-05T10:15:00+07:00", "createdAt": "2026-08-05T10:15:00+07:00", "notes": null, "reasonCode": null },
      { "status": "PICKING_UP",    "created_at": "2026-08-05T10:28:00+07:00", "createdAt": "2026-08-05T10:28:00+07:00", "notes": null, "reasonCode": null },
      { "status": "IN_DELIVERY",   "created_at": "2026-08-05T10:45:00+07:00", "createdAt": "2026-08-05T10:45:00+07:00", "notes": null, "reasonCode": null }
    ],
    "quote": {
      "service":  { "category": "EXPRESS", "type": "INSTANT", "name": "Dash Express" },
      "currency": { "code": "IDR", "symbol": "Rp" },
      "amount":   15000,
      "distance": 8200,
      "estimatedTimeline": {
        "pickup":  "2026-08-05T10:30:00.000Z",
        "dropoff": "2026-08-05T12:00:00.000Z"
      },
      "origin": {
        "address": "Jl. Sudirman No. 1, Jakarta",
        "coordinates": { "latitude": -6.2088, "longitude": 106.8456 },
        "notes": "Lobby, ask for reception"
      },
      "destination": {
        "address": "Jl. Thamrin No. 20, Jakarta",
        "coordinates": { "latitude": -6.195, "longitude": 106.823 },
        "notes": null
      },
      "packages": [
        { "name": "Document", "type": "REGULAR", "description": "Contract papers", "quantity": 1, "weight": 0.5, "length": null, "width": null, "height": null }
      ]
    },
    "sender":    { "firstName": "Andi", "lastName": "Wijaya", "companyName": "PT Maju Bersama", "phone": "+628123456789" },
    "recipient": {
      "firstName": "Siti", "lastName": "Rahma", "companyName": "CV Sejahtera",
      "email": "siti@example.com", "phone": "+628987654321",
      "actualRecipientName": null, "actualRecipientRelation": null
    },
    "instructions": [{ "text": "Call on arrival", "type": "NOTE", "url": null }],
    "advanceInfo": null,
    "cashOnDelivery": null,
    "additionalInfo": null,
    "createdAt":   "2026-08-05T10:10:00.000Z",
    "updatedAt":   "2026-08-05T10:45:00.000Z",
    "pickupAt":    "2026-08-05T10:28:00.000Z",
    "completedAt": "",
    "pickup_sla_status":   "On Time",
    "complete_sla_status": "Waiting",
    "delay_duration_minutes": 0
  }
}

{
  "status": "Success",
  "message": "Data fetched successfully",
  "requestId": "req-9c4b77",
  "meta": {
    "requestID": "req-9c4b77",
    "timestamp": "2026-08-05T11:32:44+07:00"
  },
  "data": {
    "deliveryID": "DEL-EXP-20260805-0001",
    "providerOrderID": "PO-99120",
    "paymentMethod": "CASH",
    "status": "COMPLETED",
    "invoiceNo": "INV-2026-0811",
    "trackingURL": "https://track.dashelectric.id/live/trk_9f8e7d6c",
    "courier": {
      "name": "Budi Santoso",
      "phone": "+628111222333",
      "profileImageUrl": "https://storage.googleapis.com/driver-media/selfies/99.jpg",
      "vehiclePlateNumber": "B 1234 XYZ"
    },
    "media": [
      { "type": "DELIVERY_PROOF", "url": "https://storage.googleapis.com/delivery-bucket/pod/DEL-EXP-20260805-0001/proof.jpg", "createdAt": "2026-08-05T11:52:00.000Z" }
    ],
    "timeline": [
      { "status": "PENDING_PICKUP", "created_at": "2026-08-05T10:15:00+07:00", "createdAt": "2026-08-05T10:15:00+07:00", "notes": null, "reasonCode": null },
      { "status": "PICKING_UP",    "created_at": "2026-08-05T10:28:00+07:00", "createdAt": "2026-08-05T10:28:00+07:00", "notes": null, "reasonCode": null },
      { "status": "IN_DELIVERY",   "created_at": "2026-08-05T10:45:00+07:00", "createdAt": "2026-08-05T10:45:00+07:00", "notes": null, "reasonCode": null },
      { "status": "COMPLETED",     "created_at": "2026-08-05T11:50:00+07:00", "createdAt": "2026-08-05T11:50:00+07:00", "notes": null, "reasonCode": null }
    ],
    "quote": {
      "service":  { "category": "EXPRESS", "type": "INSTANT", "name": "Dash Express" },
      "currency": { "code": "IDR", "symbol": "Rp" },
      "amount":   15000,
      "distance": 8200,
      "estimatedTimeline": {
        "pickup":  "2026-08-05T10:30:00.000Z",
        "dropoff": "2026-08-05T12:00:00.000Z"
      },
      "origin": {
        "address": "Jl. Sudirman No. 1, Jakarta",
        "coordinates": { "latitude": -6.2088, "longitude": 106.8456 },
        "notes": "Lobby, ask for reception"
      },
      "destination": {
        "address": "Jl. Thamrin No. 20, Jakarta",
        "coordinates": { "latitude": -6.195, "longitude": 106.823 },
        "notes": null
      },
      "packages": [
        { "name": "Document", "type": "REGULAR", "description": "Contract papers", "quantity": 1, "weight": 0.5, "length": null, "width": null, "height": null }
      ]
    },
    "sender":    { "firstName": "Andi", "lastName": "Wijaya", "companyName": "PT Maju Bersama", "phone": "+628123456789" },
    "recipient": {
      "firstName": "Siti", "lastName": "Rahma", "companyName": "CV Sejahtera",
      "email": "siti@example.com", "phone": "+628987654321",
      "actualRecipientName": "Dewi Lestari", "actualRecipientRelation": "Sibling"
    },
    "instructions": [{ "text": "Call on arrival", "type": "NOTE", "url": null }],
    "advanceInfo": null,
    "cashOnDelivery": { "amount": 15000 },
    "additionalInfo": null,
    "createdAt":   "2026-08-05T10:10:00.000Z",
    "updatedAt":   "2026-08-05T11:50:00.000Z",
    "pickupAt":    "2026-08-05T10:28:00.000Z",
    "completedAt": "2026-08-05T11:50:00.000Z",
    "pickup_sla_status":   "On Time",
    "complete_sla_status": "On Time",
    "delay_duration_minutes": 0
  }
}

{
  "status": "Success",
  "message": "Data fetched successfully",
  "requestId": "req-2d7e55",
  "meta": {
    "requestID": "req-2d7e55",
    "timestamp": "2026-08-05T11:32:44+07:00"
  },
  "data": {
    "deliveryID": "DEL-EXP-20260805-0001",
    "providerOrderID": "PO-99120",
    "paymentMethod": "QRIS",
    "status": "FAILED",
    "invoiceNo": "INV-2026-0811",
    "trackingURL": "https://track.dashelectric.id/live/trk_9f8e7d6c",
    "courier": {
      "name": "Budi Santoso",
      "phone": "+628111222333",
      "profileImageUrl": "https://storage.googleapis.com/driver-media/selfies/99.jpg",
      "vehiclePlateNumber": "B 1234 XYZ"
    },
    "media": [
      { "type": "FAILED_PROOF", "url": "https://storage.googleapis.com/delivery-bucket/failed/DEL-EXP-20260805-0001/proof.jpg", "createdAt": "2026-08-05T13:12:00.000Z" }
    ],
    "timeline": [
      { "status": "PENDING_PICKUP", "created_at": "2026-08-05T10:15:00+07:00", "createdAt": "2026-08-05T10:15:00+07:00", "notes": null, "reasonCode": null },
      { "status": "PICKING_UP",    "created_at": "2026-08-05T10:28:00+07:00", "createdAt": "2026-08-05T10:28:00+07:00", "notes": null, "reasonCode": null },
      { "status": "IN_DELIVERY",   "created_at": "2026-08-05T10:45:00+07:00", "createdAt": "2026-08-05T10:45:00+07:00", "notes": null, "reasonCode": null },
      { "status": "FAILED",        "created_at": "2026-08-05T13:10:00+07:00", "createdAt": "2026-08-05T13:10:00+07:00", "notes": "Recipient unreachable after 3 attempts", "reasonCode": "EB1003" }
    ],
    "quote": {
      "service":  { "category": "EXPRESS", "type": "INSTANT", "name": "Dash Express" },
      "currency": { "code": "IDR", "symbol": "Rp" },
      "amount":   15000,
      "distance": 8200,
      "estimatedTimeline": {
        "pickup":  "2026-08-05T10:30:00.000Z",
        "dropoff": "2026-08-05T12:00:00.000Z"
      },
      "origin": {
        "address": "Jl. Sudirman No. 1, Jakarta",
        "coordinates": { "latitude": -6.2088, "longitude": 106.8456 },
        "notes": "Lobby, ask for reception"
      },
      "destination": {
        "address": "Jl. Thamrin No. 20, Jakarta",
        "coordinates": { "latitude": -6.195, "longitude": 106.823 },
        "notes": null
      },
      "packages": [
        { "name": "Document", "type": "REGULAR", "description": "Contract papers", "quantity": 1, "weight": 0.5, "length": null, "width": null, "height": null }
      ]
    },
    "sender":    { "firstName": "Andi", "lastName": "Wijaya", "companyName": "PT Maju Bersama", "phone": "+628123456789" },
    "recipient": {
      "firstName": "Siti", "lastName": "Rahma", "companyName": "CV Sejahtera",
      "email": "siti@example.com", "phone": "+628987654321",
      "actualRecipientName": null, "actualRecipientRelation": null
    },
    "instructions": [{ "text": "Call on arrival", "type": "NOTE", "url": null }],
    "advanceInfo": { "failedReason": "Recipient unreachable after 3 attempts" },
    "cashOnDelivery": null,
    "additionalInfo": null,
    "createdAt":   "2026-08-05T10:10:00.000Z",
    "updatedAt":   "2026-08-05T13:10:00.000Z",
    "pickupAt":    "2026-08-05T10:28:00.000Z",
    "completedAt": "",
    "pickup_sla_status":   "On Time",
    "complete_sla_status": "Late",
    "delay_duration_minutes": 70
  }
}

{
  "status": "Success",
  "message": "Data fetched successfully",
  "requestId": "req-7k1p33",
  "meta": {
    "requestID": "req-7k1p33",
    "timestamp": "2026-08-05T11:32:44+07:00"
  },
  "data": {
    "deliveryID": "DEL-EXP-20260805-0001",
    "providerOrderID": "PO-99120",
    "paymentMethod": "CASH",
    "status": "RETURNED",
    "invoiceNo": "INV-2026-0811",
    "trackingURL": "https://track.dashelectric.id/live/trk_9f8e7d6c",
    "courier": {
      "name": "Budi Santoso",
      "phone": "+628111222333",
      "profileImageUrl": "https://storage.googleapis.com/driver-media/selfies/99.jpg",
      "vehiclePlateNumber": "B 1234 XYZ"
    },
    "media": [
      { "type": "RETURN_PROOF", "url": "https://storage.googleapis.com/delivery-bucket/return/DEL-EXP-20260805-0001/proof.jpg", "createdAt": "2026-08-05T16:20:00.000Z" }
    ],
    "timeline": [
      { "status": "PENDING_PICKUP", "created_at": "2026-08-05T10:15:00+07:00", "createdAt": "2026-08-05T10:15:00+07:00", "notes": null, "reasonCode": null },
      { "status": "PICKING_UP",     "created_at": "2026-08-05T10:28:00+07:00", "createdAt": "2026-08-05T10:28:00+07:00", "notes": null, "reasonCode": null },
      { "status": "IN_DELIVERY",    "created_at": "2026-08-05T10:45:00+07:00", "createdAt": "2026-08-05T10:45:00+07:00", "notes": null, "reasonCode": null },
      { "status": "FAILED",         "created_at": "2026-08-05T13:10:00+07:00", "createdAt": "2026-08-05T13:10:00+07:00", "notes": "Recipient rejected package", "reasonCode": "EB1006" },
      { "status": "PENDING_RETURN", "created_at": "2026-08-05T13:30:00+07:00", "createdAt": "2026-08-05T13:30:00+07:00", "notes": null, "reasonCode": null },
      { "status": "IN_RETURN",      "created_at": "2026-08-05T14:00:00+07:00", "createdAt": "2026-08-05T14:00:00+07:00", "notes": null, "reasonCode": null },
      { "status": "RETURNED",       "created_at": "2026-08-05T16:20:00+07:00", "createdAt": "2026-08-05T16:20:00+07:00", "notes": null, "reasonCode": null }
    ],
    "quote": {
      "service":  { "category": "EXPRESS", "type": "INSTANT", "name": "Dash Express" },
      "currency": { "code": "IDR", "symbol": "Rp" },
      "amount":   15000,
      "distance": 8200,
      "estimatedTimeline": {
        "pickup":  "2026-08-05T10:30:00.000Z",
        "dropoff": "2026-08-05T12:00:00.000Z"
      },
      "origin": {
        "address": "Jl. Sudirman No. 1, Jakarta",
        "coordinates": { "latitude": -6.2088, "longitude": 106.8456 },
        "notes": "Lobby, ask for reception"
      },
      "destination": {
        "address": "Jl. Thamrin No. 20, Jakarta",
        "coordinates": { "latitude": -6.195, "longitude": 106.823 },
        "notes": null
      },
      "packages": [
        { "name": "Document", "type": "REGULAR", "description": "Contract papers", "quantity": 1, "weight": 0.5, "length": null, "width": null, "height": null }
      ]
    },
    "sender":    { "firstName": "Andi", "lastName": "Wijaya", "companyName": "PT Maju Bersama", "phone": "+628123456789" },
    "recipient": {
      "firstName": "Siti", "lastName": "Rahma", "companyName": "CV Sejahtera",
      "email": "siti@example.com", "phone": "+628987654321",
      "actualRecipientName": null, "actualRecipientRelation": null
    },
    "instructions": [{ "text": "Call on arrival", "type": "NOTE", "url": null }],
    "advanceInfo": null,
    "cashOnDelivery": null,
    "additionalInfo": null,
    "createdAt":   "2026-08-05T10:10:00.000Z",
    "updatedAt":   "2026-08-05T16:20:00.000Z",
    "pickupAt":    "2026-08-05T10:28:00.000Z",
    "completedAt": "2026-08-05T16:20:00.000Z",
    "pickup_sla_status":   "On Time",
    "complete_sla_status": "Late",
    "delay_duration_minutes": 260
  }
}

Headers​

Parameters​

Response envelope​

Response fields​

Media types​

State-by-state reference​

Error responses​

Headers

Parameters

Response envelope

Response fields

Media types

State-by-state reference

Error responses