Skip to main content
GET
Get Telephony Numbers
Returns the numbers available to you. Behavior depends on the Org-Handle header:
  • With Org-Handle — returns your organization’s own numbers (any state) plus the shared unassigned pool (NOT_ASSIGNED).
  • Without Org-Handle — returns only the shared unassigned pool.
Use a number’s id when attaching it to a trunk.
Prerequisites: API Token. See Authentication.

Headers

Number object fields

cURL

Authorizations

Authorization
string
header
required

Format: Token

Headers

Org-Handle
string

Organization domain handle. Omit to list pool numbers only.

Response

List of telephony numbers