Phone Numbers

POST

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

Phone Numbers

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

Orders one or more numbers through supported providers and reserves them in local inventory. Note: This endpoint only purchases/reserves numbers. SMS/MMS capabilities must be configured separately via SPAPI2 microservice.

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

Order operation completed

Body

🟠400

🟠401

🟠403

🟠404

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://platform-api.convirza.com/v3/phone-numbers/order' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "phone_numbers": [
        {
            "number": "+14255551212",
            "source": 10001
        }
    ]
}'

Response Example

200 - Example 1

{
    "code": 200,
    "message": "Success",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2026-02-26T18:00:00.000Z",
    "data": {
        "total": 2,
        "success_count": 1,
        "error_count": 1,
        "data": [
            {
                "number": "+14255551212",
                "message": "Number ordered successfully"
            }
        ]
    }
}

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

Reserved Numbers

Available Numbers