Skip to main content
GET
/
api
/
user
/
assistants
/
phone-numbers
Retrieve Available Phone Numbers
curl --request GET \
  --url https://app.famulor.de/api/user/assistants/phone-numbers \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": 2103,
    "phone_number": "+491748236179",
    "country_code": "DE",
    "type_label": "Caller ID",
    "is_available": true
  },
  {
    "id": 2131,
    "phone_number": "+4915792613301",
    "country_code": "DE",
    "type_label": "Caller ID",
    "is_available": true
  }
]
This endpoint returns a list of phone numbers belonging to 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

The API returns a direct array of available phone numbers:
​
array
array
Array of available phone numbers

​
Notes

  • Only phone numbers belonging to 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 a values collection format (indexed array)
  • Use the id field when assigning phone numbers to assistants
[
  {
    "id": 2103,
    "phone_number": "+491748236179",
    "country_code": "DE",
    "type_label": "Caller ID",
    "is_available": true
  },
  {
    "id": 2131,
    "phone_number": "+4915792613301",
    "country_code": "DE",
    "type_label": "Caller ID",
    "is_available": true
  }
]
Related pages: Introduction and Authentication Guide, and API Integration Examples.