Use the /user/idv/retry endpoint to retry identity verification (IDV) for a user. This endpoint allows you to trigger a new identity verification session against the specified provider.
You must provide one of the following:
- A
providerAND aproviderIdvSessionId
OR
- An
idvSessionId— which is the Spidr-specific session ID.
Use retryScope to choose how much of the verification to re-run:
-
failed— resume at the step the user failed, keeping the steps they already passed. Whether a session can be resumed is the provider's decision, not ours: a session whose failing step was a screening or a risk check is refused, and the provider may refuse others it cannot resume. Retry withallif that happens. -
all— re-run the whole verification from the start. This is the default.
Which individual steps each scope runs is determined by the IDV template configured for your product, not by the request.
