Notify driver

Sends a side-band notification to the assigned driver — currently used to signal that the package is physically ready for pickup. Allowed only while status is PENDING_PICKUP or PICKING_UP.

POST/express/v1/deliveries/{deliveryID}/additional-notifications

⚠

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

Headers

Authorizationstringrequired

Bearer token.

Parameters

deliveryIDstringrequired

Path parameter.

typestringrequired

Currently only READY_TO_PICKUP is supported.

Error responses

400VALIDATION_FAILED — payload validation failed; the message names the first failing field.

404DELIVERY_NOT_FOUND — deliveryID doesn't exist. Pengantaran tidak ditemukan.

400NO_COURIER_ASSIGNED — no courier assigned yet. Kurir belum ditugaskan untuk antaran ini.

400DELIVERY_STATUS_NOT_NOTIFIABLE — wrong status; must be PENDING_PICKUP or PICKING_UP. Notifikasi tidak dapat dikirim karena status pengantaran tidak sesuai.

Request

curl https://api.dashelectric.co/express/v1/deliveries/DE-1727921269869/additional-notifications \
  -H "Authorization: Bearer $DASH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "type": "READY_TO_PICKUP" }'

Response 200 OK

{
  "status":  "Success",
  "message": "Notifikasi berhasil dikirim"
}

Error responses

400 NO_COURIER_ASSIGNED

{
  "status":    "Failed",
  "error":     "Kurir belum ditugaskan untuk antaran ini.",
  "errorCode": "NO_COURIER_ASSIGNED",
  "requestId": "3f0c9a2e-7b1d-4c55-9e0a-1d2b6f8a4c10"
}

400 DELIVERY_STATUS_NOT_NOTIFIABLE

{
  "status":    "Failed",
  "error":     "Notifikasi tidak dapat dikirim karena status pengantaran tidak sesuai.",
  "errorCode": "DELIVERY_STATUS_NOT_NOTIFIABLE",
  "requestId": "3f0c9a2e-7b1d-4c55-9e0a-1d2b6f8a4c10"
}

404 DELIVERY_NOT_FOUND

{
  "status":    "Failed",
  "error":     "Pengantaran tidak ditemukan.",
  "errorCode": "DELIVERY_NOT_FOUND",
  "requestId": "3f0c9a2e-7b1d-4c55-9e0a-1d2b6f8a4c10"
}