***

title: Phone Numbers
slug: /reference/python/rest/compat/phone-numbers
description: Manage phone numbers, search available inventory, and import numbers.
max-toc-depth: 3
---------------------

For a complete index of all SignalWire documentation pages, fetch https://signalwire.com/docs/llms.txt

[restclient]: /docs/server-sdks/reference/python/rest/client

[list]: /docs/server-sdks/reference/python/rest/compat/phone-numbers/list

[purchase]: /docs/server-sdks/reference/python/rest/compat/phone-numbers/purchase

[get]: /docs/server-sdks/reference/python/rest/compat/phone-numbers/get

[update]: /docs/server-sdks/reference/python/rest/compat/phone-numbers/update

[delete]: /docs/server-sdks/reference/python/rest/compat/phone-numbers/delete

[importnumber]: /docs/server-sdks/reference/python/rest/compat/phone-numbers/import-number

[listavailablecountries]: /docs/server-sdks/reference/python/rest/compat/phone-numbers/list-available-countries

[searchlocal]: /docs/server-sdks/reference/python/rest/compat/phone-numbers/search-local

[searchtollfree]: /docs/server-sdks/reference/python/rest/compat/phone-numbers/search-toll-free

Manage incoming phone numbers with CRUD operations, search available inventory
by country, and import external numbers.

Access via `client.compat.phone_numbers` on a [`RestClient`][restclient] instance.

```python {9}
from signalwire.rest import RestClient

client = RestClient(
    project="your-project-id",
    token="your-api-token",
    host="your-space.signalwire.com",
)

numbers = client.compat.phone_numbers.list()
```

## **Methods**

### Phone Number CRUD

<CardGroup cols={3}>
  <Card title="list" href="/docs/server-sdks/reference/python/rest/compat/phone-numbers/list">
    List incoming phone numbers in the account.
  </Card>

  <Card title="purchase" href="/docs/server-sdks/reference/python/rest/compat/phone-numbers/purchase">
    Purchase a new phone number.
  </Card>

  <Card title="get" href="/docs/server-sdks/reference/python/rest/compat/phone-numbers/get">
    Retrieve a single phone number by SID.
  </Card>

  <Card title="update" href="/docs/server-sdks/reference/python/rest/compat/phone-numbers/update">
    Update a phone number's configuration.
  </Card>

  <Card title="delete" href="/docs/server-sdks/reference/python/rest/compat/phone-numbers/delete">
    Release a phone number.
  </Card>
</CardGroup>

### Import

<CardGroup cols={2}>
  <Card title="import_number" href="/docs/server-sdks/reference/python/rest/compat/phone-numbers/import-number">
    Import an external phone number.
  </Card>
</CardGroup>

### Available Numbers

<CardGroup cols={3}>
  <Card title="list_available_countries" href="/docs/server-sdks/reference/python/rest/compat/phone-numbers/list-available-countries">
    List countries with available phone numbers.
  </Card>

  <Card title="search_local" href="/docs/server-sdks/reference/python/rest/compat/phone-numbers/search-local">
    Search for available local numbers in a country.
  </Card>

  <Card title="search_toll_free" href="/docs/server-sdks/reference/python/rest/compat/phone-numbers/search-toll-free">
    Search for available toll-free numbers in a country.
  </Card>
</CardGroup>