---
title: "Search US local numbers available to provision"
method: GET
path: "/api/v1/phone-numbers/available"
tags: ["SMS"]
---

# Search US local numbers available to provision

`GET /api/v1/phone-numbers/available`

## Request

- Base URL: `https://cooperemail.com`
- URL: `https://cooperemail.com/api/v1/phone-numbers/available`
- Auth: HTTP bearer

Requires inbox_read. area_code is a 3-digit US area code (HTTP 400 invalid_area_code). contains is matched against the number. limit is 1 to 20 and defaults to 5 (HTTP 400 invalid_limit). Each row is {e164, number_type, capabilities}. HTTP 404 not_found when SMS is off.

## Query parameters

- `area_code` string
- `contains` string
- `limit` integer

## Response `200`

Inventory matches

## Other responses

- `400`: invalid_area_code or invalid_limit
- `404`: not_found

---

[API](https://skmtc.dev/cooperemail/apis/cooper-email-api.md) · [All operations](https://skmtc.dev/cooperemail/apis/cooper-email-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cooperemail/apis/cooper-email-api/revisions/6d800a7b3e33?raw)