Returns the proof lifecycle for Quick Escrow with Proof escrows, including time-limited viewUrl links you can show on your site. Raw S3 keys are never returned.
Only available when the escrow was created with fulfillmentPolicy.type: "purchase_proof_required". Requires API key access to the escrow (you created it or your associated user is buyer/seller).
curl -X GET https://dhmad.tn/api/v1/escrows/507f1f77bcf86cd799439011/proof \
-H "Authorization: Bearer sk_live_your_api_key_here"
{
"proof": {
"phase": "submitted_waiting_buyer_review",
"correctionRounds": 0,
"uploadDeadline": "2026-06-20T10:00:00.000Z",
"reviewDeadline": "2026-06-21T10:00:00.000Z",
"submissionCount": 1,
"submissions": [
{
"submittedAt": "2026-06-19T14:00:00.000Z",
"note": "Receipt from Apple Store",
"attachments": [
{
"mimeType": "image/jpeg",
"viewUrl": "https://cdn.dhmad.tn/escrow-proof/..."
}
]
}
],
"latestSubmission": {
"submittedAt": "2026-06-19T14:00:00.000Z",
"note": "Receipt from Apple Store",
"attachments": [
{
"mimeType": "image/jpeg",
"viewUrl": "https://cdn.dhmad.tn/escrow-proof/..."
}
]
},
"checkoutActions": [
{
"action": "review_proof",
"targetUserEmail": "buyer@example.com",
"description": "Create a checkout session with this action and redirect the buyer to DHMAD to accept the proof or request corrections."
}
]
}
}
Path Parameters
Response Fields
viewUrl links expire. Refresh via this endpoint or handle proof webhooks — do not cache URLs long-term.
Errors
| Status | Meaning |
|---|
| 400 | Escrow does not use purchase proof (fulfillmentPolicy not set). |
| 403 | Your API key cannot access this escrow. |
| 404 | Escrow not found. |