Idempotency

Use idempotency keys to safely retry requests without creating duplicate resources. Include the Idempotency-Key header with a unique value (UUID recommended).

Usage

curl -X POST https://api.verifyhq.com/v1/verifications/identity \
  -H "X-API-Key: your_api_key" \
  -H "Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000" \
  -H "Content-Type: application/json" \
  -d '{"userId": "user_123", "tier": "BASIC"}'

Behavior

• First request: processed normally, response cached with the key
• Repeated request (same key): returns the cached response without re-processing
• Keys expire after 24 hours
• Different request body with same key returns 422 error