Skip to content

/api/auth/two-factor/verify-totp

POST
/api/auth/two-factor/verify-totp
curl --request POST \
--url https://example.com/api/auth/two-factor/verify-totp \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "code": "example", "trustDevice": true }'

Verify two factor TOTP

Media typeapplication/json
object
code
required

The otp code to verify. Eg: “012345”

string
trustDevice

If true, the device will be trusted for 30 days. It’ll be refreshed on every sign in request within this time. Eg: true

boolean
Examplegenerated
{
"code": "example",
"trustDevice": true
}

Successful response

Media typeapplication/json
object
status
boolean
Examplegenerated
{
"status": true
}

Bad Request. Usually due to missing parameters, or invalid parameters.

Media typeapplication/json
object
message
required
string
Examplegenerated
{
"message": "example"
}

Unauthorized. Due to missing or invalid authentication.

Media typeapplication/json
object
message
required
string
Examplegenerated
{
"message": "example"
}

Forbidden. You do not have permission to access this resource or to perform this action.

Media typeapplication/json
object
message
string
Examplegenerated
{
"message": "example"
}

Not Found. The requested resource was not found.

Media typeapplication/json
object
message
string
Examplegenerated
{
"message": "example"
}

Too Many Requests. You have exceeded the rate limit. Try again later.

Media typeapplication/json
object
message
string
Examplegenerated
{
"message": "example"
}

Internal Server Error. This is a problem with the server that you cannot fix.

Media typeapplication/json
object
message
string
Examplegenerated
{
"message": "example"
}