***

title: Phone Numbers
slug: /reference/typescript/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/typescript/rest/client

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

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

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

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

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

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

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

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

[searchtollfree]: /docs/server-sdks/reference/typescript/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.phoneNumbers` on a [`RestClient`][restclient] instance.

```typescript {9}
import { RestClient } from "@signalwire/sdk";

const client = new RestClient({
  project: "your-project-id",
  token: "your-api-token",
  host: "your-space.signalwire.com"
});

const numbers = await client.compat.phoneNumbers.list();
```

## **Methods**

### Phone Number CRUD

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

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

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

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

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

### Import

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

### Available Numbers

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

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

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