answers / proof-of-delivery-api
How does an AI agent get proof that a delivery happened?
Short answer. Every drop-off declares proof_required (photo, signature, recipient name, OTP, ID check). The driver app cannot complete the stop without it, and GET /v1/deliveries/{id}/proof returns signed photo URLs, the signature, the recipient's name, the coordinates and the timestamp.
Best for
- ✓ Contracts and legal documents
- ✓ High-value items with an OTP handoff
- ✓ Audit trails for automated fulfilment
Limits and responsibilities
- • Signed URLs expire after one hour; fetch again when needed
- • OTP requires you to give the recipient the code out of band
How it works
- 01Set proof_required on the drop-off when creating
- 02For OTP, pass metadata.otp and tell the recipient
- 03After delivered, call get_proof_of_delivery
create_deliveryget_proof_of_deliveryconfirm_deliveryopen_dispute