Approving and rejecting a verification (API)

When the person being verified completes all checks, the verification moves to the awaiting_review state and waits for the sender's review. You can review and decide in the Signi app or via the API:

Approval

curl -X POST -H "x-api-key: YOUR_API_KEY" \
  https://api.signi.com/api/v2/verifications/VERIFICATION_UUID/approve

Returns 204 with no body. The verification moves to approved and remains valid for the period defined by the verification group (expiresAt in the detail). Approval is only possible from the awaiting_review state (otherwise 409); re-approving an already approved verification does no harm.

Rejection

curl -X POST -H "x-api-key: YOUR_API_KEY" -H "Content-Type: application/json" \
  https://api.signi.com/api/v2/verifications/VERIFICATION_UUID/reject \
  -d '{ "reason": "The document is illegible", "spawnRetry": true }'

{ "retryVerificationUuid": "aaaa1111-bbbb-2222-cccc-333344445555" }

• Rejection is final and irreversible — the verification stays rejected forever.
• reason — an optional reason; the person being verified will see it, and it is saved to the verification.
• spawnRetry — true creates a new linked attempt (a copy with the same offered groups) so the person being verified can try again; its UUID comes in the response. The default false = reject without a second chance.
• Rejection is possible from the awaiting_review and in_progress states.

Note: spawnRetry only works while the documents linked to the verification are still "alive" (in progress, awaiting completion, or awaiting signature). For a completed or expired document, a new attempt cannot be created — the call returns 409 and nothing is rejected.

Rejection vs. decline

Don't confuse two similar states: rejected = rejected by the sender (this chapter), declined = the person being verified themselves refused to go through the verification — you'll find their reason in the detail as declinedReason.

Where to go next

• Signi verification — how it works — all states
• Verification webhooks — notifications about approval or rejection