Verify backup code

POST /api/experience/verification/backup-code/verify

Create a new BackupCode verification record and verify the provided backup code against the user's backup codes. The verification record will be marked as verified if the code is correct.

application/json

Body Required

  • code string Required

    The backup code to verify.

    Minimum length is 1.

Responses

  • 200 application/json

    The backup code has been successfully verified.

    Hide response attribute Show response attribute object
    • verificationId string Required

      The unique verification ID of the BackupCode verification record.
  • 400

    The provided backup code is invalid.

  • 404

    Entity not found.
    - session.identifier_not_found: The current interaction is not identified yet. All MFA verification records must be associated with a identified user.

POST /api/experience/verification/backup-code/verify 
curl \
 --request POST https://[tenant_id].logto.app/api/experience/verification/backup-code/verify \
 --header "Content-Type: application/json" \
 --data '{"code":"string"}'
Request examples 
{
  "code": "string"
}
Response examples (200) 
{
  "verificationId": "string"
}