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.

GET /sca/factors/reset/{resetId}

Get 2FA reset status

cURL

curl --request GET \
  --url https://api.lightspark.com/grid/2025-10-13/sca/factors/reset/{resetId} \
  --header 'Authorization: Basic <encoded-value>'

200

{
  "status": "INITIATED",
  "factor": "SMS_OTP",
  "expiresAt": "2025-10-03T12:15:00Z",
  "enrollmentStatus": "PENDING",
  "completedAt": null
}

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

200

application/json

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>

The enrollment status of the replacement factor. Absent for an SMS_OTP reset, where completing the reset enrolls the new number directly with no separate enrollment step.

Available options: PENDING, COMPLETED

Example:

"PENDING"

completedAt · string<date-time> | null

When the reset completed; null until then.

Example:

null