Authenticate with TOTP

Complete authentication using a Time-based One-Time Password (TOTP) after initial password verification.

POST /accounts/auth-with-totp

Authenticate with TOTP

cURL

curl --request POST \
  --url https://api.quiva.ai/accounts/auth-with-totp \
  --header 'Content-Type: application/json' \
  --data '
{
  "token": "mfa_token_abcdef1234567890",
  "code": "123456"
}
'

200

{
  "data": {
    "refresh_token": "<string>",
    "auth_token": "<string>",
    "passkey_enabled": true,
    "totp_enabled": true
  }
}

Body

application/json

token · string · required

MFA token received from password authentication

code · string · required

6-digit TOTP code from authenticator app

email · string<email>

User's email address (optional when authenticated)

Response

200

application/json

Authentication successful

data · object · required

Show child attributes