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

# Second factor status

> When the authenticator in use was confirmed and how many recovery codes are left.



## OpenAPI

````yaml openapi/en/control.json GET /v1/users/me/second-factor
openapi: 3.1.0
info:
  title: Niadra control API
  version: '1'
  description: >-
    Tenants, projects, sources, keys, people, configuration and usage. It never
    receives customer content.
servers:
  - url: https://control.api.niadra.com
security: []
paths:
  /v1/users/me/second-factor:
    get:
      summary: Second factor status
      description: >-
        The second factor of the signed-in person: when the authenticator in use
        was confirmed, and how

        many recovery codes are left.


        **Authentication.** Person token issued by the control plane
        (`Authorization: Bearer <JWT>`), with the role the operation needs.
      operationId: my_second_factor_v1_users_me_second_factor_get
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SecondFactorStatusOut'
              example:
                confirmed_at: '2026-09-22T11:02:00Z'
                recovery_codes_left: 9
          description: The second factor of the person.
      security:
        - personToken: []
components:
  schemas:
    SecondFactorStatusOut:
      additionalProperties: false
      properties:
        confirmed_at:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          description: >-
            When the authenticator in use was confirmed; null while there is
            none.
          title: Confirmed At
        recovery_codes_left:
          description: Recovery codes not used yet.
          title: Recovery Codes Left
          type: integer
      required:
        - confirmed_at
        - recovery_codes_left
      title: SecondFactorStatusOut
      type: object
  securitySchemes:
    personToken:
      type: http
      scheme: bearer
      bearerFormat: JWT

````