Reserve Phone Number

POST

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

Number

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

Reserves phone numbers from carrier inventory into your private pool. Reserved numbers become exclusively available to your organization and can be provisioned to call flows. Use after searching carrier inventory to secure desired numbers.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Reservation confirmation with status for each requested number

Headers

Body

🟠400

🟠401

🟠403

🟠404

🔴500

⚪default

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://apicfa.convirza.com/v2/number/reserve' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '[
    {
        "number_id": 0,
        "number": 1000000000,
        "source": 0
    }
]'

Response Example

200 - Example 1

[
    {
        "result": "string",
        "data": "string",
        "entry_count": 0
    }
]

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

Search Reserved Numbers

List Geo Locations