> ## Documentation Index
> Fetch the complete documentation index at: https://docs.receptonic.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get available phone numbers

> Retrieve all available phone numbers for assistant assignment

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`

**properties**

**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 for 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)

```json 200 Response theme={null}
[
  {
    "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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.