Skip to main content
GET
/
user
/
assistants
/
phone-numbers
Get available phone numbers
curl --request GET \
  --url https://call.aiployees.com/api/user/assistants/phone-numbers \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": 45,
    "phone_number": "+1234567890",
    "country_code": "US",
    "type_label": "Normal",
    "is_available": true
  },
  {
    "id": 46,
    "phone_number": "+1234567891",
    "country_code": "US",
    "type_label": "SIP",
    "is_available": false
  },
  {
    "id": 47,
    "phone_number": "+441234567890",
    "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
[
  {
    "id": 45,
    "phone_number": "+1234567890",
    "country_code": "US",
    "type_label": "Normal",
    "is_available": true
  },
  {
    "id": 46,
    "phone_number": "+1234567891",
    "country_code": "US",
    "type_label": "SIP",
    "is_available": false
  },
  {
    "id": 47,
    "phone_number": "+441234567890",
    "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