***

title: Phone Numbers
slug: /reference/typescript/rest/phone-numbers
description: Search and manage phone 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/phone-numbers/list

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

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

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

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

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

Search for available phone numbers, purchase them, and manage the numbers in your
SignalWire project. This resource extends the standard CRUD pattern with a `search()`
method for discovering available numbers and uses PUT for updates.

Access via `client.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 available = await client.phoneNumbers.search({ areacode: "512" });
for (const number of available.data ?? []) {
    console.log(number.phoneNumber);
}
```

## **Methods**

<CardGroup cols={3}>
  <Card title="list" href="/docs/server-sdks/reference/typescript/rest/phone-numbers/list">
    List phone numbers owned by the project.
  </Card>

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

  <Card title="get" href="/docs/server-sdks/reference/typescript/rest/phone-numbers/get">
    Retrieve details for a specific phone number.
  </Card>

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

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

  <Card title="search" href="/docs/server-sdks/reference/typescript/rest/phone-numbers/search">
    Search for available phone numbers to purchase.
  </Card>
</CardGroup>