<!-- Source: https://docs.vinsi.ai/api-docs/phone-numbers-area-code -->
# Get Phone Numbers by Area Code

Search for local phone numbers available to purchase in a 3-digit area code (up to 100 results with voice and SMS). countryCode defaults to US. Purchase one with Create Phone Number.

```http
GET https://dashboard.vinsi.ai/api/phone-numbers/available?areaCode={areaCode}
```

## Authentication

Send your API key in the `x-api-key` header. Create keys in the VINSI dashboard under Settings → API Keys.

## Headers

| Name | Type | Required |
|---|---|---|
| Content-Type | string | yes (application/json) |
| x-api-key | string | yes |

## Query parameters

| Name | Required | Example |
|---|---|---|
| areaCode | yes | 619 |
| countryCode | no | US |

## Example request

```bash
curl -X GET 'https://dashboard.vinsi.ai/api/phone-numbers/available?areaCode=619' \
  -H 'x-api-key: YOUR_API_KEY'
```

## Example response

```json
{
  "numbers": [
    "+16195550123"
  ],
  "numbersDetailed": [
    {
      "phoneNumber": "+16195550123",
      "friendlyName": "+16195550123",
      "locality": "SAN DIEGO",
      "region": "CA",
      "postalCode": null,
      "rateCenter": "SAN DIEGO",
      "isoCountry": "US",
      "capabilities": {
        "voice": true,
        "sms": true,
        "mms": false,
        "fax": false
      }
    }
  ],
  "isTollFree": false
}
```