---
title: "List Phone Numbers"
method: GET
path: "/user/phone-numbers/all"
tags: ["Phone Numbers"]
---

# List Phone Numbers

`GET /user/phone-numbers/all`

## Request

- Base URL: `https://app.famulor.de/api`
- URL: `https://app.famulor.de/api/user/phone-numbers/all`
- Auth: HTTP bearer

Retrieves all phone numbers of the authenticated user

[Docs](https://docs.famulor.io/api-v1/phone-numbers/list)

## Response `200`

Success

- object
  - `data` object[]: Array of phone number objects
    - `id` integer: The unique identifier of the phone number
    - `phone_number` string: The phone number in E.164 format (e.g. +49155551234)
    - `nickname` string, nullable: A short, human-friendly label for the number (or `null` if not set)
    - `country_code` string: The ISO 3166-1 alpha-2 country code (e.g. DE, GB, AU)
    - `type` string: The type of phone number: `normal`, `sip` or `caller_id`
    - `type_label` string: Human-readable label for the phone number type
    - `sms_capable` boolean: Whether the phone number can send and receive SMS
    - `region` string: The region where the phone number was provisioned
    - `has_active_subscription` boolean: Whether the phone number has an active subscription
    - `created_at` string: ISO 8601 timestamp of when the phone number was purchased

## Other responses

- `401`: Fehlender oder ungültiger API-Key.
- `422`: Die Anfrage ist inhaltlich ungültig.

---

[API](https://skmtc.dev/famulor/apis/famulor-api.md) · [All operations](https://skmtc.dev/famulor/apis/famulor-api/llms.txt) · [OpenAPI document](https://skmtc.dev/famulor/apis/famulor-api/revisions/3b938c370721?raw)