---
title: "GET /search#type=phone-numbers"
method: GET
path: "/search#type=phone-numbers"
---

# GET /search#type=phone-numbers

`GET /search#type=phone-numbers`

Searches the provisioned phone numbers in an organization.

## Query parameters

- `area-code` string
- `city` string
- `country` string
- `state` string
- `toll-free-prefix` string
- `phone-number-type` 'Local' | 'TollFree'
- `max-results` integer
- `next-token` string
- `type` 'phone-numbers', required

## Response `200`

Success

- SearchAvailablePhoneNumbersResponse
  - `E164PhoneNumbers` E164PhoneNumber[] — Confines a search to just the phone numbers in the E.164 format.
  - `NextToken` string — The token used to return the next page of results.

## Other responses

- `480` — BadRequestException
- `481` — ForbiddenException
- `482` — AccessDeniedException
- `483` — UnauthorizedClientException
- `484` — ThrottledClientException
- `485` — ServiceUnavailableException
- `486` — ServiceFailureException

---

[API](https://skmtc.net/aws/apis/chime-sdk-voice.md) · [All operations](https://skmtc.net/aws/apis/chime-sdk-voice/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/chime-sdk-voice/versions/89ce97d6fad9/schema)