Authentication

Confirm 2FA enrolment

post/auth/totp/confirm

Verify the first code to enable 2FA. Returns one-time backup codes.

Authorization

Bearer token in the Authorization header.

Body required

codestringrequired

6-digit code from your authenticator app

Response

backupCodesstring[]required

One-time backup codes, shown once

Request

curl -X POST 'https://api.lira.com/api/v1/auth/totp/confirm' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
  "code": "123456"
}'

const response = await fetch('https://api.lira.com/api/v1/auth/totp/confirm', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "code": "123456"
  }),
});

const data = await response.json();

import requests

response = requests.post(
    "https://api.lira.com/api/v1/auth/totp/confirm",
    headers={"Authorization": "Bearer YOUR_ACCESS_TOKEN"},
    json={
  "code": "123456"
},
)

data = response.json()

Response

{
  "backupCodes": [
    "string"
  ]
}

{
  "message": "NG Account Number verification is not enabled for your organisation.",
  "code": "SERVICE_NOT_ENABLED",
  "action": {
    "type": "CONTACT_ADMIN",
    "hint": "Ask your administrator to enable NG Account Number verification in the Lira dashboard."
  }
}