Get available phone numbers

Retrieve all available phone numbers for assistant assignment

GET /user/assistants/phone-numbers

Get available phone numbers

cURL

curl --request GET \
  --url https://app.voicery.ai/api/user/assistants/phone-numbers \
  --header 'Authorization: Bearer <token>'

200 Response

[
  {
    "id": 45,
    "phone_number": "[phone]",
    "country_code": "US",
    "type_label": "Normal",
    "is_available": true
  },
  {
    "id": 46,
    "phone_number": "[phone]",
    "country_code": "US",
    "type_label": "SIP",
    "is_available": false
  },
  {
    "id": 47,
    "phone_number": "[phone]",
    "country_code": "GB",
    "type_label": "Caller ID",
    "is_available": true
  }
]

This endpoint returns a list of phone numbers owned by the authenticated user that can be assigned to assistants, with optional filtering by assistant type.

Query Parameters

type · string

Filter phone numbers by assistant type. Options: inbound, outbound

Response fields

data · array

Show properties

id · integer

The unique identifier of the phone number

phone_number · string

The phone number in E.164 format

country_code · string

The country code for the phone number

type_label · string

The human-readable type label for the phone number

is_available · boolean

Whether the phone number is available for assignment (not currently assigned to an inbound assistant)

200 Response

[
  {
    "id": 45,
    "phone_number": "[phone]",
    "country_code": "US",
    "type_label": "Normal",
    "is_available": true
  },
  {
    "id": 46,
    "phone_number": "[phone]",
    "country_code": "US",
    "type_label": "SIP",
    "is_available": false
  },
  {
    "id": 47,
    "phone_number": "[phone]",
    "country_code": "GB",
    "type_label": "Caller ID",
    "is_available": true
  }
]

Notes

• Only phone numbers owned by the authenticated user are returned
• When type=inbound is specified, caller ID numbers and already assigned numbers are filtered out
• The is_available field indicates if the number can be assigned to a new inbound assistant
• Phone numbers are returned in the values collection format (indexed array)
• Use the id field when assigning phone numbers to assistants