---
title: "Search through the phone number inventory for list of available numbers"
method: GET
path: "/number/search"
tags: ["number"]
---

# Search through the phone number inventory for list of available numbers

`GET /number/search`

Searches available phone numbers from carrier inventory based on area code, prefix, pattern, or geographic location. Returns available numbers that can be reserved and provisioned. Numbers showing null number_id are carrier-available and require reservation before provisioning. See the Knowledge Base article for complete workflow instructions.

## Query parameters

- `npa` integer
- `nxx` integer
- `ocn` integer
- `match` string
- `rc` string
- `state` string

## Response `200`

Available phone numbers with carrier information. Null number_id indicates carrier-available numbers requiring reservation.

- NumberResponse[]
  - `number_id` integer — The unique identifier for the phone number record
  - `number` integer, required — The full actual phone number
  - `source` integer, required — Indicator that identifies which source where the number is located

## Other responses

- `default` — Unexpected error

---

[API](https://skmtc.net/convirza/apis/convirza-apis.md) · [All operations](https://skmtc.net/convirza/apis/convirza-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/convirza/convirza-apis/versions/ccf9bbe34f5a/schema)