Skip to main content
GET
Get 2FA reset status

Authorizations

Authorization
string
header
required

API token authentication using format <api token id>:<api client secret>

Path Parameters

resetId
string
required

The reset handle returned by the start call.

Query Parameters

customerId
string
required

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.

status
enum<string>
required

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.

Available options:
INITIATED,
PENDING_REVIEW,
LIVENESS_PASSED,
COMPLETED,
REJECTED,
EXPIRED
Example:

"INITIATED"

factor
enum<string>
required

The factor being reset.

Available options:
SMS_OTP,
TOTP,
PASSKEY
expiresAt
string<date-time>
required

When the reset window closes. Poll no longer than this.

Example:

"2025-10-03T12:15:00Z"

enrollmentStatus
enum<string> | null

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.

Available options:
PENDING,
COMPLETED,
null
Example:

"PENDING"

completedAt
string<date-time> | null

When the reset completed; null until then.

Example:

null