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

# Search

> StateSet Voice API operation.

StateSet Voice API operation.

### Query parameters

<ParamField query="area_code" type="string" required>
  3-digit US area code to search for available Twilio numbers
</ParamField>

### Response

No response body — available phone numbers matching the requested area code.

### Status codes

| Code  | Meaning                                                            |
| ----- | ------------------------------------------------------------------ |
| `200` | Available phone numbers matching the requested area code           |
| `400` | area\_code must be 3 digits                                        |
| `402` | Payment method required                                            |
| `404` | Number provisioning disabled or customer self-serve plane disabled |
| `502` | Number provider (Twilio) error                                     |

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://api.voice.stateset.com/api/v1/customer/numbers/search' \
    --header 'Authorization: Bearer YOUR_API_KEY'
  ```
</RequestExample>