Verify a second factor

curl --request POST \
  --url https://api.liara.ir/v1/two-fa/verify \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "twoFAType": "totp",
  "totp": "123456"
}
'

{
  "statusCode": 123,
  "error": "<string>",
  "message": "<string>",
  "data": {
    "code": "<string>"
  }
}

{
  "error": "Unauthorized."
}

{
  "statusCode": 403,
  "error": "Forbidden",
  "message": "twoFA authentication failed, recoveryCode is invalid.",
  "data": {
    "code": "two_fa_recoveryCode_invalid"
  }
}

POST

two-fa

verify

curl --request POST \
  --url https://api.liara.ir/v1/two-fa/verify \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "twoFAType": "totp",
  "totp": "123456"
}
'

{
  "statusCode": 123,
  "error": "<string>",
  "message": "<string>",
  "data": {
    "code": "<string>"
  }
}

{
  "error": "Unauthorized."
}

{
  "statusCode": 403,
  "error": "Forbidden",
  "message": "twoFA authentication failed, recoveryCode is invalid.",
  "data": {
    "code": "two_fa_recoveryCode_invalid"
  }
}

Authorizations

Authorization

string

header

required

Send your API token as Authorization: Bearer <api-token>. Tokens expire (30 days by default) and stop working when you change or reset your password.

Body

application/json

twoFAType

enum<string>

required

Which second factor you're sending. Required when two-factor authentication is enabled on the account.

Available options:

totp,

recoveryCode

totp

string

6-digit code from your authenticator app. Required when twoFAType is totp.

Required string length: 6

recoveryCode

string

One of your 10-character recovery codes. Required when twoFAType is recoveryCode.

Required string length: 10

Response

Verified. The response body is empty.

Introduction

Authentication & Account

Teams & Access

Billing & Subscription

Support & Notifications

Authorizations

Body

Response