Get 2FA reset status
Poll the status of an in-progress 2FA reset until it reaches the liveness-passed value, after which the reset can be completed.
This endpoint is only meaningful for customers in a region where SCA is required (e.g. EU). For customers outside SCA-regulated regions, this returns 409.
Authorizations
API token authentication using format <api token id>:<api client secret>
Path Parameters
The reset handle returned by the start call.
Query Parameters
The unique identifier of the customer whose reset status is polled.
Response
The current reset status.
The status of an in-progress 2FA reset, polled until it reaches a terminal value.
The reset status.
| Value | Terminal | Meaning | |-------|----------|---------| | INITIATED | no | Reset started; liveness not yet submitted. Keep polling. | | PENDING_REVIEW | no | Liveness submitted; under review. Keep polling. | | LIVENESS_PASSED | no | Liveness passed; call the complete endpoint to finish the reset. | | COMPLETED | yes | Reset finished; the lost factor is cleared and re-enrollment can begin. | | REJECTED | yes | Liveness failed. Stop polling; start a new reset. | | EXPIRED | yes | The reset window closed before it completed. Stop polling; start a new reset. |
Stop polling on any terminal value.
INITIATED, PENDING_REVIEW, LIVENESS_PASSED, COMPLETED, REJECTED, EXPIRED "INITIATED"
The factor being reset.
SMS_OTP, TOTP, PASSKEY When the reset window closes. Poll no longer than this.
"2025-10-03T12:15:00Z"
The enrollment status of the replacement factor. PENDING until the customer finishes re-enrolling, then COMPLETED. Null for an SMS_OTP reset, where completing the reset enrolls the new number directly with no separate enrollment step.
PENDING, COMPLETED, null "PENDING"
When the reset completed; null until then.
null