Get an authentication method by ID

Retrieves a single authentication method belonging to the authenticated user.

GET https://{host}/me/v1/authentication-methods/{authentication_method_id}

Get an authentication method by ID

cURL

curl --request GET \
  --url https://{host}/me/v1/authentication-methods/{authentication_method_id} \
  --header 'Authorization: Bearer <token>'

200

phone

{
  "id": "phone|dev_XXXXXXXXXXXXXXXX",
  "type": "phone",
  "confirmed": true,
  "phone_number": "[phone]",
  "preferred_authentication_method": "sms",
  "usage": [
    "secondary"
  ],
  "created_at": "2025-01-15T10:30:00.000Z"
}

Authorizations

Authorization · string · header · required

Bearer and DPoP tokens are supported depending on the API configuration

Path Parameters

authentication_method_id · string · required

Authentication Method ID. This value is part of the Location header returned when creating an authentication method. It should be used as it is, without any modifications.

Response

200

application/json

Successfully retrieved authentication method

password

passkey

recovery-code

push-notification

totp

webauthn-platform

webauthn-roaming

phone

email

id · string · required

The unique identifier of the authentication method

created_at · string<date-time> · required

The date and time when the authentication method was created

usage · enum<string>[] · required

Primary and/or secondary factor

Usage type for authentication factors

Available options: primary, secondary

type · string · default: password · required

Authentication method type (factor)

Allowed value: "password"

identity_user_id · string · required

The ID of the user identity linked with the authentication method

last_password_reset · string<date-time>

The date of the last password reset