Approving and rejecting a verification

ℹ️ The new version of Signi verification (including this API) will be released to production during September 2026. Until then, the calls are not available and the description may change slightly.

When the person being verified completes all checks, the verification moves to the awaiting_review state and waits for the requester'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 is valid for the period defined by the verification group (expiresAt in the detail). You can only approve from the awaiting_review state (otherwise 409); repeatedly 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 — optional reason; the person being verified will see it, and it is saved with 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 back in the response. Default false = reject with no second chance.
• You can reject from the awaiting_review and in_progress states.

Caution: spawnRetry only works as long as the documents linked to the verification are still "live" (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 = the requester rejected it (this chapter), declined = the person being verified themselves declined 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