Proof of Delivery Policy
Driver drop-off photos that prove the package was placed safely at the right location.
A proof-of-delivery policy for last-mile and courier workflows. It confirms a package or parcel is visible and placed at a delivery location (door, porch, mailroom, or reception), not held in hand or photographed in the vehicle, and that the shot is clear enough to serve as evidence. Use it to cut 'where's my package' disputes and chargebacks with objective photo proof.
Where this policy fits
- Last-mile and courier drop-off photos
- Contactless delivery confirmation
- Reducing 'package not received' disputes
- Audit trail for high-value deliveries
Compliance categories
Every verification resolves to exactly one category. Compliant categories pass the ride or hand-off; the rest route to retry or manual review.
Valid Delivery Proof
A package is clearly placed at a delivery location in a usable photo.
valid_podInvalid Proof
No package visible, package not placed at a location (held in hand / in vehicle), or location not identifiable.
invalid_podPoor Photo
Image quality prevents confirming the delivery.
poor_photoCriteria
Each criterion is evaluated independently. Required criteria gate the outcome; severity tunes how strictly the model interprets edge cases.
| Criterion | Severity | Required | ID |
|---|---|---|---|
Package clearly visible A package, parcel, box, envelope, or bag must be clearly visible in the photo. FAIL if no package is present. | critical | Yes | package_visible |
Package placed at a location The package must be set down at a delivery location — on a doorstep, porch, mat, in a mailroom, or at a reception. FAIL if the package is being held in someone's hand or is sitting inside the delivery vehicle. | critical | Yes | package_placed |
Delivery location identifiable Enough surrounding context (door, porch, threshold, building feature) must be visible to identify a plausible delivery location. PASS for any recognizable doorstep or entry; FAIL only if the package floats with no location context at all. | warning | Yes | location_identifiable |
Image is clear enough FAIL only if the photo is completely black, unidentifiably blurry, or a non-photo. Low-light porch photos PASS as long as the package and location are identifiable. | warning | Yes | image_clear |
Copy the policy JSON
Use this as the config for a named policy in your dashboard or send it to us to attach to your account. Once it has a stable policy ID, pass that ID to /api/v1/verify.
{
"id": "proof-of-delivery-policy",
"name": "Proof of Delivery Policy",
"config": {
"mode": "structured",
"categories": [
{
"id": "valid_pod",
"label": "Valid Delivery Proof",
"color": "#22c55e",
"isCompliant": true,
"description": "A package is clearly placed at a delivery location in a usable photo."
},
{
"id": "invalid_pod",
"label": "Invalid Proof",
"color": "#ef4444",
"isCompliant": false,
"description": "No package visible, package not placed at a location (held in hand / in vehicle), or location not identifiable."
},
{
"id": "poor_photo",
"label": "Poor Photo",
"color": "#f97316",
"isCompliant": false,
"description": "Image quality prevents confirming the delivery."
}
],
"criteria": [
{
"id": "package_visible",
"label": "Package clearly visible",
"description": "A package, parcel, box, envelope, or bag must be clearly visible in the photo. FAIL if no package is present.",
"severity": "critical",
"required": true
},
{
"id": "package_placed",
"label": "Package placed at a location",
"description": "The package must be set down at a delivery location — on a doorstep, porch, mat, in a mailroom, or at a reception. FAIL if the package is being held in someone's hand or is sitting inside the delivery vehicle.",
"severity": "critical",
"required": true
},
{
"id": "location_identifiable",
"label": "Delivery location identifiable",
"description": "Enough surrounding context (door, porch, threshold, building feature) must be visible to identify a plausible delivery location. PASS for any recognizable doorstep or entry; FAIL only if the package floats with no location context at all.",
"severity": "warning",
"required": true
},
{
"id": "image_clear",
"label": "Image is clear enough",
"description": "FAIL only if the photo is completely black, unidentifiably blurry, or a non-photo. Low-light porch photos PASS as long as the package and location are identifiable.",
"severity": "warning",
"required": true
}
],
"maxAttempts": 2,
"autoApproveOnExhaust": false,
"uiCopy": {
"scannerTitle": "Delivery Photo",
"scannerInstructions": "Place the package at the door and take a photo showing the package and the location",
"processingMessage": "Verifying delivery...",
"successMessage": "Delivery confirmed",
"failureMessage": "Delivery photo needs another try",
"retryMessage": "Make sure the package is placed at the door and visible. {remaining} attempts remaining.",
"exhaustedMessage": "Photo submitted for manual review."
}
}
}Frequently asked questions
Related policies
Vehicle Damage Inspection Policy
Handover and return inspections that flag dents, cracked glass, and missing parts before they become disputes.
View policyMicromobilityMicromobility Parking Policy
End-of-ride scooter and e-bike parking verification, hardened against the false positives that get riders wrongly fined.
View policy