Logistics

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

Compliant

A package is clearly placed at a delivery location in a usable photo.

valid_pod

Invalid Proof

Non-compliant

No package visible, package not placed at a location (held in hand / in vehicle), or location not identifiable.

invalid_pod

Poor Photo

Non-compliant

Image quality prevents confirming the delivery.

poor_photo

Criteria

Each criterion is evaluated independently. Required criteria gate the outcome; severity tunes how strictly the model interprets edge cases.

CriterionSeverityRequiredID
Package clearly visible
A package, parcel, box, envelope, or bag must be clearly visible in the photo. FAIL if no package is present.
critical
Yespackage_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
Yespackage_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
Yeslocation_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
Yesimage_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.

proof-of-delivery-policy.json
{
  "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

Get in Touch

Questions about pricing, integrations, or custom deployments? We'd love to hear from you.