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

# Get Available Phone Numbers

## Get Available Phone Numbers

Search for available phone numbers from Twilio that can be purchased.

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.example.com/api/v1/phone_numbers/available?country_code=US&area_code=415" \
    -H "X-API-Key: your-api-key-here"
  ```

  ```javascript JavaScript theme={null}
  const params = new URLSearchParams({
    country_code: 'US',
    area_code: '415'
  });

  const response = await fetch(`https://api.example.com/api/v1/phone_numbers/available?${params}`, {
    method: 'GET',
    headers: {
      'X-API-Key': 'your-api-key-here'
    }
  });

  const data = await response.json();
  ```

  ```python Python theme={null}
  import requests

  headers = {
      'X-API-Key': 'your-api-key-here'
  }

  params = {
      'country_code': 'US',
      'area_code': '415'
  }

  response = requests.get(
      'https://api.example.com/api/v1/phone_numbers/available',
      headers=headers,
      params=params
  )

  data = response.json()
  ```
</RequestExample>

<ResponseExample>
  ```json Success Response theme={null}
  {
    "status": {
      "code": 200,
      "message": "Available phone numbers retrieved successfully"
    },
    "data": [
      {
        "phone_number": "+14155551234",
        "friendly_name": "(415) 555-1234",
        "region": "US",
        "country_code": "US"
      }
    ]
  }
  ```
</ResponseExample>

<OpenApiExplorer />