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.

The signed payload's provenance is always agent_verified — this whole flow only exists because a courier confirmed at/near the destination — with confidence at 0.95 when location_verified is true, 0.4 on a failed proximity check (still a real attempt, just low location trust), and accuracy_meters set to the same distance_m already in the payload.

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