> ## Documentation Index
> Fetch the complete documentation index at: https://docs.platform.arb.inc/llms.txt
> Use this file to discover all available pages before exploring further.

# Read TOTP configuration

> Retrieves the user's TOTP configuration details including usage statistics. Does not return the secret itself.



## OpenAPI

````yaml api-reference/auth.yaml post /users/totp/read
openapi: 3.0.3
info:
  title: auth
  description: >-
    The Auth Service is the single source of truth for all accounts and their
    permissions, managing authentication and access control across the platform.
    It maintains efficiency at scale by issuing access tokens to accounts when
    they log into the platform and providing public keys for other services to
    verify them.
  version: 1.0.0
servers:
  - url: https://auth.platform.arb.inc
security: []
tags:
  - name: /
  - name: authenticate
  - name: internal
  - name: organizations
  - name: sessions
  - name: users
paths:
  /users/totp/read:
    post:
      tags:
        - users
      summary: Read TOTP configuration
      description: >-
        Retrieves the user's TOTP configuration details including usage
        statistics. Does not return the secret itself.
      operationId: readTOTP
      responses:
        '200':
          description: Successfully retrieved TOTP configuration
          content:
            application/json:
              schema:
                type: object
        '404':
          description: TOTP is not configured
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      description: access token
      scheme: bearer
      bearerFormat: JWT

````