---
title: "Search available managed SMS numbers"
method: GET
path: "/v1/sms-numbers/available"
tags: ["Credentials"]
---

# Search available managed SMS numbers

`GET /v1/sms-numbers/available`

## Request

- Base URL: `https://api.skyvern.com`
- URL: `https://api.skyvern.com/v1/sms-numbers/available`
- Auth: API key in header `x-api-key`

Search for available US Skyvern-managed SMS numbers, optionally by area code.

## Query parameters

- `area_code` string, nullable

## Response `200`

Successful Response

- AvailableManagedPhoneNumber[]
  - `phone_number` string, required
  - `friendly_name` string, nullable
  - `locality` string, nullable
  - `region` string, nullable
  - `iso_country` string, nullable
  - `monthly_price_cents` integer, required

## Other responses

- `403`: Managed SMS numbers are not enabled or the plan is not entitled
- `422`: Validation Error
- `502`: The phone number provider request failed

## Changes

- **2026-10-27** `dc7de12b8e80`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/skyvern-ai/apis/skyvern-api-2/changes/v1/sms-numbers/available/get.md)

---

[API](https://skmtc.dev/skyvern-ai/apis/skyvern-api-2.md) - [All operations](https://skmtc.dev/skyvern-ai/apis/skyvern-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/skyvern-ai/apis/skyvern-api-2/revisions/64479cb160ff?raw)