Search Phone Numbers

GET

https://apicfa.convirza.com/v2/number/search

Number

Last modified:2026-04-03 12:54:09

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.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Responses

🟢200

application/json

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

Headers

Body

🟠400

🟠401

🟠403

🟠404

🔴500

⚪default

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://apicfa.convirza.com/v2/number/search?npa&nxx&ocn&match&rc&state' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

[
    {
        "number_id": 0,
        "number": 1000000000,
        "source": 0
    }
]

Modified at 2026-04-03 12:54:09

List Group Call Logs

Search Reserved Numbers