Essentials
Calls
Contact Custom Fields
Contacts
Conversations
Phone Numbers
List phone numbers
Retrieve the list of phone numbers and users associated with your OpenPhone workspace.
Query Parameters
Filter results to return only phone numbers associated with the specified user"s unique identifier.
Response
Timestamp of when the phone number was added to the account in ISO 8601 format.
A human-readable representation of a phone number.
Forwarding number for incoming calls, null if no forwarding number is configured.
The unique identifier of the group to which the OpenPhone number belongs.
The unique identifier of OpenPhone phone number.
The display name of the phone number
A phone number in E.164 format, including the country code.
Current status of the porting process, if applicable.
Unique identifier for the phone number’s porting request, if applicable.
Phone number usage restrictions for messaging and calling by region. Use these properties to know if a particular phone number is allowed to message or call a number in a region.
Region-specific restrictions, including United States, Canada, and International (outside of US or CA).
The phone-number usage restriction status for a specific region
restricted, unrestricted The phone-number usage restriction status for a specific region
restricted, unrestricted The phone-number usage restriction status for a specific region
restricted, unrestricted Region-specific restrictions, including United States, Canada, and International (outside of US or CA).
The phone-number usage restriction status for a specific region
restricted, unrestricted The phone-number usage restriction status for a specific region
restricted, unrestricted The phone-number usage restriction status for a specific region
restricted, unrestricted Custom symbol or emoji associated with the phone number.
Timestamp of the last update to the phone number's details in ISO 8601 format.
Was this page helpful?