---
title: "Search Available"
method: GET
path: "/v1/numbers/search"
tags: ["Phone Provisioning", "Phone Provisioning"]
---

# Search Available

`GET /v1/numbers/search`

## Request

- Base URL: `https://api.call2me.app`
- URL: `https://api.call2me.app/v1/numbers/search`
- Auth: HTTP bearer

Search available numbers (Telnyx or Twilio).

provider verilmezse ülkeye göre otomatik (US/CA→telnyx, diğer→twilio).
Returns numbers with OUR sell price.

## Query parameters

- `country` string
- `locality` string, nullable
- `area_code` string, nullable
- `phone_number_type` string
- `limit` integer
- `provider` string, nullable

## Response `200`

Successful Response

- SearchResponse
  - `numbers` AvailableNumber[], required
    - `phone_number` string, required
    - `country_code` string, required
    - `phone_number_type` string, required
    - `telnyx_cost_usd` number, required
    - `monthly_price_usd` number, required
    - `upfront_price_usd` number, required
    - `features` string[], required
    - `locality` string, nullable
    - `provider` string
  - `total` integer, required
  - `requires_payment` boolean
  - `upfront_price_usd` number
  - `address_required` boolean

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/call2me/apis/call2me-api.md) · [All operations](https://skmtc.dev/call2me/apis/call2me-api/llms.txt) · [OpenAPI document](https://skmtc.dev/call2me/apis/call2me-api/revisions/3951f9b7e47d?raw)