Skip to main content
GET
/
api
/
user
/
phone-numbers
/
all
List Phone Numbers
curl --request GET \
  --url https://app.famulor.de/api/user/phone-numbers/all \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": 1,
      "phone_number": "+49155551234",
      "country_code": "DE",
      "type": "normal",
      "type_label": "Dedicated Number",
      "sms_capable": true,
      "region": "us1",
      "has_active_subscription": true,
      "created_at": "2025-01-07T10:30:00.000000Z"
    },
    {
      "id": 2,
      "phone_number": "+442071234567",
      "country_code": "GB",
      "type": "normal",
      "type_label": "Dedicated Number",
      "sms_capable": false,
      "region": "us1",
      "has_active_subscription": true,
      "created_at": "2025-01-05T14:20:00.000000Z"
    }
  ]
}
This endpoint returns a list of all phone numbers linked to your account, including their subscription status and capabilities.
There is also a legacy endpoint GET /user/phone-numbers that only returns SMS-capable phone numbers with active subscriptions. Use this /all endpoint when you need all phone numbers regardless of SMS capability or subscription status.

​
Response Fields

​
data
array
Array of phone number objects
{
  "data": [
    {
      "id": 1,
      "phone_number": "+49155551234",
      "country_code": "DE",
      "type": "normal",
      "type_label": "Dedicated Number",
      "sms_capable": true,
      "region": "us1",
      "has_active_subscription": true,
      "created_at": "2025-01-07T10:30:00.000000Z"
    },
    {
      "id": 2,
      "phone_number": "+442071234567",
      "country_code": "GB",
      "type": "normal",
      "type_label": "Dedicated Number",
      "sms_capable": false,
      "region": "us1",
      "has_active_subscription": true,
      "created_at": "2025-01-05T14:20:00.000000Z"
    }
  ]
}
Related pages: Introduction and Authentication Guide, and API Integration Examples.