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

# Get Authenticators

> Gets a list of the user's currently enrolled authenticators.



## OpenAPI

````yaml server-api GET /users/{userId}/authenticators
openapi: 3.0.0
info:
  description: Authsignal's Server API.
  version: 1.0.0
  title: Server API
  termsOfService: https://www.authsignal.com/legal/terms-of-service
  contact:
    email: hello@authsignal.com
servers:
  - url: https://api.authsignal.com/v1
  - url: https://au.api.authsignal.com/v1
  - url: https://eu.api.authsignal.com/v1
  - url: https://ca.api.authsignal.com/v1
security:
  - basicAuth: []
tags:
  - name: users
    description: ''
    externalDocs:
      description: Find out more
      url: https://docs.authsignal.com
  - name: challenge
    description: ''
    externalDocs:
      description: Find out more
      url: https://docs.authsignal.com
  - name: authenticator configurations
    description: ''
    externalDocs:
      description: Find out more
      url: https://docs.authsignal.com
  - name: actions
    description: ''
    externalDocs:
      description: Find out more
      url: https://docs.authsignal.com
  - name: query
    description: ''
    externalDocs:
      description: Find out more
      url: https://docs.authsignal.com
  - name: email
    description: ''
    externalDocs:
      description: Find out more
      url: https://docs.authsignal.com
  - name: sms
    description: ''
    externalDocs:
      description: Find out more
      url: https://docs.authsignal.com
  - name: verify
    description: ''
    externalDocs:
      description: Find out more
      url: https://docs.authsignal.com
  - name: challenges
    description: ''
    externalDocs:
      description: Find out more
      url: https://docs.authsignal.com
  - name: sessions
    description: ''
    externalDocs:
      description: Find out more
      url: https://docs.authsignal.com
  - name: devices
    description: ''
    externalDocs:
      description: Find out more
      url: https://docs.authsignal.com
externalDocs:
  description: Find out more about Authsignal
  url: https://docs.authsignal.com
paths:
  /users/{userId}/authenticators:
    get:
      tags:
        - challenge
      summary: Get user authenticators
      description: Gets a list of the user's currently enrolled authenticators.
      operationId: getUserAuthenticators
      parameters:
        - $ref: '#/components/parameters/userId'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/UserAuthenticator'
        '400':
          $ref: '#/components/responses/InvalidRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
components:
  parameters:
    userId:
      name: userId
      in: path
      description: The ID of the user.
      required: true
      schema:
        type: string
  schemas:
    UserAuthenticator:
      type: object
      properties:
        userAuthenticatorId:
          type: string
        verificationMethod:
          $ref: '#/components/schemas/VerificationMethod'
        email:
          type: string
        phoneNumber:
          type: string
        username:
          type: string
        displayName:
          type: string
        createdAt:
          type: string
          format: date-time
        verifiedAt:
          type: string
          format: date-time
        lastVerifiedAt:
          type: string
          format: date-time
        previousSmsChannel:
          type: string
          enum:
            - DEFAULT
            - WHATSAPP
          description: >-
            The channel that was last used by the user to complete an SMS
            challenge. Only defined if the verification method is SMS.
        webauthnCredential:
          type: object
          properties:
            credentialId:
              type: string
            deviceId:
              type: string
            name:
              type: string
              description: >-
                The name of the passkey. Defaults to `aaguidMapping.name` if
                available.
            aaguid:
              type: string
            aaguidMapping:
              type: object
              properties:
                name:
                  type: string
                  description: >-
                    The name of the credential manager where the passkey is
                    stored e.g. 'iCloud Keychain'.
                svgIconLight:
                  type: string
                  description: >-
                    A base64 encoded light variant SVG icon for the credential
                    manager.
                svgIconDark:
                  type: string
                  description: >-
                    A base64 encoded dark variant SVG icon for the credential
                    manager.
            credentialBackedUp:
              type: boolean
            credentialDeviceType:
              type: string
              enum:
                - singleDevice
                - multiDevice
            authenticatorAttachment:
              type: string
              enum:
                - cross-platform
                - platform
            parsedUserAgent:
              type: object
              properties:
                ua:
                  type: string
                browser:
                  type: object
                  properties:
                    name:
                      type: string
                    version:
                      type: string
                    major:
                      type: string
                device:
                  type: object
                  properties:
                    model:
                      type: string
                    type:
                      type: string
                    vendor:
                      type: string
                engine:
                  type: object
                  properties:
                    name:
                      type: string
                    version:
                      type: string
                os:
                  type: object
                  properties:
                    name:
                      type: string
                    version:
                      type: string
                cpu:
                  type: object
                  properties:
                    architecture:
                      type: string
        deviceName:
          type: string
          description: >-
            The name of the device (e.g. 'iPhone 16 Pro'). Only used for PUSH
            verification methods.
      required:
        - userAuthenticatorId
        - verificationMethod
        - createdAt
      example:
        userAuthenticatorId: 4efd2d0d-3278-4e03-8143-d9a0850bebc0
        verificationMethod: PASSKEY
        username: jane.smith@authsignal.com
        displayName: Jane Smith
        createdAt: '2024-05-13T04:59:02.640Z'
        lastVerifiedAt: '2024-07-13T02:43:37.640Z'
        verifiedAt: '2024-05-13T04:59:17.640Z'
        webauthnCredential:
          credentialId: 71273a99-4a7b-47d4-82ab-9ea72b8f0a72
          deviceId: d5a13d2d-8c34-4c90-938b-d8c6e3a88c5d
          name: iCloud Keychain
          aaguid: fbfc3007-154e-4ecc-8c0b-6e020557d7bd
          aaguidMapping:
            name: iCloud Keychain
            svgIconDark: data:image/svg+xml;base64...
            svgIconLight: data:image/svg+xml;base64...
          credentialBackedUp: true
          credentialDeviceType: multiDevice
          authenticatorAttachment: platform
    VerificationMethod:
      type: string
      enum:
        - SMS
        - AUTHENTICATOR_APP
        - EMAIL_MAGIC_LINK
        - EMAIL_OTP
        - PUSH
        - DEVICE
        - SECURITY_KEY
        - PASSKEY
        - VERIFF
        - IPROOV
        - PALM_BIOMETRICS_RR
        - IDVERSE
    Error:
      type: object
      properties:
        error:
          type: string
        errorDescription:
          type: string
      required:
        - error
  responses:
    InvalidRequest:
      description: Invalid Request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Unauthorized:
      description: Unauthorized
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: >-
        Use your Authsignal Server API secret key as the username and leave the
        password empty. The secret key can be found in the API Keys section of
        the Authsignal Portal settings page.

````