List TOTP devices

List the TOTP devices of the current user

GET/{apiBasePath}/totp/device/list

Authorization

AuthorizationBearer token · headerrequired

Returned as the "st-access-token" header from sign-in and refresh endpoints and present on requests that update the access token payload

sAccessTokenAPI key · cookierequired

This is an HTTPOnly cookie, set by sign-in and refresh endpoints and present on requests that update the access token

Path parameters

apiBasePathstringrequired

Its value depends on the apiBasePath set by the user

Header parameters

ridstring

The TOTP recipe ID

anti-csrftoken

This will only be here if enabled by the user.

Responses

200The list of the TOTP devices of the session user

One of:

object

statusstatusOK

Success status indicator

Allowed:OK

devicesobject[]

Show properties

Array of object

namestring

periodnumber

skewnumber

verifiedboolean

generalErrorResponse

statusstring

Error status code

Allowed:GENERAL_ERROR

messagestring

Error message

404Resource not found error

string

500Internal server error

string

Try it

Server

Custom base URLOverrides the selected server when set.

Authorization

Bearer tokenRemember on this deviceInclude my values in samples

Parameters

apiBasePathpath*Its value depends on the apiBasePath set by the userridheaderThe TOTP recipe IDanti-csrfheaderThis will only be here if enabled by the user.

Request

curl -X GET "/auth/totp/device/list" \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch("/auth/totp/device/list", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  }
});

import requests

response = requests.get(
    "/auth/totp/device/list",
    headers={
        "Authorization": "Bearer YOUR_TOKEN"
    },
)

Response

{
  "status": "OK",
  "devices": [
    {
      "name": "asdf123",
      "period": 30,
      "skew": 30,
      "verified": false
    }
  ]
}

"Not Found"

"Internal Error"