Confirm a delivery (verify + signed receipt)

POST 
/v2/pod/confirm

Verify a delivery at the drop. Provide pod_id (from /v2/pod/issue) OR order_ref + destination for a one-shot location-only proof. AfriHex checks the courier is within radius_m of the destination, verifies the recipient code if one was issued, records the outcome, and returns a tamper-evident Ed25519-signed receipt. A failed check is still recorded (status: "failed") — never silently dropped. Emits a delivery.confirmed webhook.

Request

Responses

200

Delivery proof recorded

400

Missing/invalid fields

404

Proof of delivery not found

409

Already confirmed

429

Rate limit exceeded

Response Headers

X-RateLimit-Limit

Maximum requests allowed in the window

X-RateLimit-Remaining

Requests remaining in current window

Retry-After

Seconds until the rate limit resets