---
title: "Retrieve Available Phone Numbers"
method: GET
path: "/user/assistants/phone-numbers"
tags: ["Assistants"]
---

# Retrieve Available Phone Numbers

`GET /user/assistants/phone-numbers`

## Request

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

Retrieve all available phone numbers for assistant assignment

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

## Query parameters

- `type` 'inbound' | 'outbound'

## Response `200`

OK

- object[]
  - `array` object[]: Array of available phone numbers
    - `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 of 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)

## 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)