Phone Numbers

Retrieve a phone number

Changed on

Returns the details of a phone number

get/phone_numbers/{phone_number_id}

Request

  • Base URL
    https://api.clerk.com/v1
  • URL
    https://api.clerk.com/v1/phone_numbers/{phone_number_id}
  • Auth
    HTTP bearer

Path parameters

phone_number_idstring required

The ID of the phone number to retrieve

Response

Success

idstring
object'phone_number' required

String representing the object's type. Objects of the same type share the same value.

phone_numberstring required
reserved_for_second_factorboolean
default_second_factorboolean
reservedboolean required
backup_codesstring[] nullable
created_atinteger required

Unix timestamp of creation

updated_atinteger required

Unix timestamp of creation

Changes

  • 2025-11-104db0b9e2d5e6Revision changes
    • info

      added the optional property ///// to the response with the status