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

# Search available phone numbers

> Search for available phone numbers that can be purchased

This endpoint allows you to search for available phone numbers from our provider. Use the results to find a number you want to purchase.

### Query Parameters

**country\_code** `string` (default: US)

The ISO 3166-1 alpha-2 country code to search in (e.g., US, GB, AU, CA)

**contains** `string`

Filter phone numbers that contain specific digits (numeric characters only, max 10 digits)

### Response

**data** `array`

Array of available phone numbers

**available number properties**

**phone\_number** `string`

The phone number in E.164 format

**phone\_number\_formatted** `string`

The phone number formatted for display

**country\_code** `string`

The ISO country code

**price** `number`

Monthly rental price in USD

**stripe\_price\_id** `string`

The Stripe price ID for billing

**address\_requirements** `string`

Address requirements for this number: `none`, `local`, `foreign`, or `inventory`

**sms\_capable** `boolean`

Whether the number supports SMS

```json 200 Response theme={null}
{
  "data": [
    {
      "phone_number": "+14155551234",
      "phone_number_formatted": "+1 415-555-1234",
      "country_code": "US",
      "price": 3.99,
      "stripe_price_id": "price_1PkA4dBXoZOzqQuAsvGvVJTZ",
      "address_requirements": "none",
      "sms_capable": true
    },
    {
      "phone_number": "+14155555678",
      "phone_number_formatted": "+1 415-555-5678",
      "country_code": "US",
      "price": 3.99,
      "stripe_price_id": "price_1PkA4dBXoZOzqQuAsvGvVJTZ",
      "address_requirements": "none",
      "sms_capable": false
    }
  ]
}
```

```json 200 Empty Response theme={null}
{
  "data": []
}
```

### Supported Countries

| Country | Code |
| - | - |
| United States | US |
| Canada | CA |
| United Kingdom | GB |
| Australia | AU |
| Israel | IL |
| Poland | PL |
| Finland | FI |
| Netherlands | NL |
| Denmark | DK |
| Italy | IT |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.