Get TOTP Recovery Codes (beta)

POST /v1/auth/totps/recovery_codes

Get TOTP (time-based one-time passcode) recovery codes of the given user ID.

HTTP Request

POST /v1/auth/totps/recovery_codes


A successful response returns an object with user_id and totps properties that contain the recovery codes.


  • user_id string Required

    Required User ID to retrieve TOTP recovery codes for.

    Minimum length is 1.


POST /v1/auth/totps/recovery_codes
curl \
 -X POST \
 -H "Authorization: Bearer $ACCESS_TOKEN" \
 -H "Content-Type: application/json" \
 -d '{"user_id":"user_26l7dbfAY59ftejmm6m3OTf4oz1"}'
Request example
  "user_id": "user_26l7dbfAY59ftejmm6m3OTf4oz1"
Response example (200)
  "user_id": "user_26l7dbfAY59ftejmm6m3OTf4oz1",
  "totps": [
      "id": "totp_27LbM1TMjS3gQN1vuzb1jn8Fshw",
      "verified": true,
      "recovery_codes": [