Search Reserved Numbers

GET

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

Number

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

Searches phone numbers that have been reserved for your organization but not yet provisioned. Returns numbers from your private reserved inventory that are ready to be assigned to call flows. Supports filtering by area code, prefix, or pattern.

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

Reserved phone numbers available for provisioning

Headers

Body

🟠400

🟠401

🟠403

🟠404

🔴500

⚪default

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

200 - Example 1

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

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

Search Phone Numbers

Reserve Phone Number