Accesskey5

Activeflow5

Agent11

AI34

Auth8

Billing12

Call24

Campaign14

Case10

Conference14

Contact17

Conversation11

Customer13

Email4

Extension8

Flow6

Groupcall5

Interaction2

Me1

Message4

Number9

Outdial11

Outplan6

Provider6

ProviderCall4

Queue13

RAG7

Recording4

Route5

Service Agent66

ServiceAgent9

Speaking7

Storage10

Tag5

Team6

Timeline8

Transcribe6

Transfer1

Trunk5

Webchat15

Websocket1

Number

List available numbers

Get available phone numbers for the specified country or virtual numbers.

get/available_numbers

Query parameters

page_sizeinteger

Example:25

Number of results to return per page.

country_codestring

The ISO country code. Required when type is not virtual.

type'normal' | 'virtual'

The type of the number.

Example:normal

The type of available numbers to retrieve (normal or virtual). Defaults to normal.

Response

A list of available phone numbers.

Example response

{
  "result": [
    {
      "number": "+14155551234",
      "country": "US",
      "region": "California",
      "postal_code": "94105",
      "features": [
        "voice"
      ]
    }
  ]
}

Changes

Changed in 2 of the 54 revisions of this API.21010

Jun 26, 2026788bc9d03134110See the full diff
- ▲
  the allOf[subschema #1]/result/items/ response's property type/format changed from string/ to object/ for status 200
  response-property-type-changed
- ○
  added the optional property allOf[subschema #1]/result/items/country to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property allOf[subschema #1]/result/items/features to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property allOf[subschema #1]/result/items/number to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property allOf[subschema #1]/result/items/postal_code to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property allOf[subschema #1]/result/items/region to the response with the 200 status
  response-optional-property-added
- ○
  removed the emergency enum value from the allOf[subschema #1]/result/items/ response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the fax enum value from the allOf[subschema #1]/result/items/ response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the mms enum value from the allOf[subschema #1]/result/items/ response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the sms enum value from the allOf[subschema #1]/result/items/ response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the voice enum value from the allOf[subschema #1]/result/items/ response property for the response status 200
  response-property-enum-value-removed
May 30, 2026995c56ba9219110See the full diff
- ▲
  the allOf[subschema #1]/result/items/ response's property type/format changed from object/ to string/ for status 200
  response-property-type-changed
- ●
  removed the optional property allOf[subschema #1]/result/items/country from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property allOf[subschema #1]/result/items/features from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property allOf[subschema #1]/result/items/number from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property allOf[subschema #1]/result/items/postal_code from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property allOf[subschema #1]/result/items/region from the response with the 200 status
  response-optional-property-removed
- ●
  added the new emergency enum value to the allOf[subschema #1]/result/items/ response property for the response status 200
  response-property-enum-value-added
- ●
  added the new fax enum value to the allOf[subschema #1]/result/items/ response property for the response status 200
  response-property-enum-value-added
- ●
  added the new mms enum value to the allOf[subschema #1]/result/items/ response property for the response status 200
  response-property-enum-value-added
- ●
  added the new sms enum value to the allOf[subschema #1]/result/items/ response property for the response status 200
  response-property-enum-value-added
- ●
  added the new voice enum value to the allOf[subschema #1]/result/items/ response property for the response status 200
  response-property-enum-value-added
This revision also has 20 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history