Photo proof of delivery

Deliveroo Express includes a Photo Proof of Delivery (PPOD) feature that provides visual confirmation of completed deliveries. When an order is delivered without a direct handover, riders capture a photo showing where the order was placed. This feature enhances transparency for customers, reduces disputes, and supports greater accuracy and trust across the Deliveroo Express experience.

Steps for Integrators to Enable Photo Proof of Delivery (PPOD)

Customer requests a delivery and specifies that a photo proof of delivery is required.
Deliveroo assigns a rider
Rider completes the delivery with photo proof by taking a photo as proof.
Deliveroo will send the delivery status - Delivered
The partner can request the Get delivery linked to the Delivery ID. These files details will include the photo/file ID.
Download and store the photo
1. Use the signed URL to download the Get delivery photo.
2. Save the photo securely in your own system before the URL expires.

❗️
Note

The downloaded files do not include a file extension (e.g., .jpg). Please ensure you manually add the appropriate extension after downloading the images from the URL.

A single order may have multiple file IDs when large orders require more than one rider. In such cases, each file ID must be called individually to retrieve its corresponding photo.

Example Payload JSONs

{
	"dropoff_details": {
    "notes": "Call me when you've arrived!",
    "phone_number": "+44XXXXXXX",
    "verification": {
      "type": "PHOTO" // This will trigger the photo proof of delivery feature for that Delivery
    }
  }
}


{
  "event": "delivery.update_status",
  "body": {
    "delivery_id": "e49db1e9-3cd4-4d1a-9e69-b0c9e3732c0a",
    "external_ref_id": "Testing-XXX",
    "status": {
      "effective_at": "2025-11-20T16:55:37Z",
      "effective_at_nano": "2025-11-20T16:55:37.528Z",
      "status": "REQUESTED"
    },
    "verification": {
      "type": "PHOTO",
      "value": ""
    }
  }
}

{
	"delivery_files": [
    {
      "file_id": "6f89053d-1228-4a70-8bf6-d7281ef60f86", 
      "rider_id": "e49db1e9-3cd4-4d1a-9e69-b0c9e3732c0a", //Rider 1
      "type": "DELIVERY_PROOF"
    },
    {
      "file_id": "1249000a-12a2-4b6d-a5a3-3613b14e7d0e", 
      "rider_id": "a7213f50-53fd-4606-a506-09afde8a8c8f ", // Rider 2 (when applicable, for example in the case of a large order)
      "type": "DELIVERY_PROOF"
    }
  ]
}

{
  "url": "https://uploads.deliveroo.com/view/XX_vUAD77-9Ux3vv71m77-977-977-9OAbvv70ZcO-_vSw=",
  "expires_at": "2025-09-25T15:06:43.205Z"
}