Skip to main content

Record a failed delivery attempt

POST 

/v2/trips/:id/attempts

Paid API plans only. Records why a delivery didn't happen and what happens next. The courier's last pinged position is saved with the attempt; away_from_destination flags one logged far from the address.

next_actionThe trip becomes
retrystarted (or pending if the courier never set off), for another try
reschedulepending, with reschedule_to as its new scheduled_arrival_at (within 14 days). The recipient's page shows the new time.
returnreturning. Give return_to for an ETA back to the sender; finish with PATCH status=returned
stopfailed, and the trip closes

Allowed on any open trip that isn't already returning, up to 10 per trip. The recipient's page never shows the reason, note or calls. Every attempt fires trip.attempt_failed.

Request​

Responses​

Recorded; the updated trip