Available Numbers

GET

https://platform-api.convirza.com/v3/phone-numbers/search

Phone Numbers

Last modified:2026-04-03 14:27:57

Returns currently unprovisioned numbers from inventory. match cannot be combined with other filters. rc and state must be supplied together.

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 returned successfully

Body

🟠400

🟠401

🟠404

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://platform-api.convirza.com/v3/phone-numbers/search?limit&npa&nxx&ocn&match&rc&state' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "code": 200,
    "message": "Success",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2026-02-26T18:00:00.000Z",
    "data": [
        {
            "number": "4255551212",
            "source": 10001
        }
    ]
}

Modified at 2026-04-03 14:27:57

Phone Numbers

List Provisioned Routes