Cloud Number Purchase Package Details

Usage Instructions

Obtain cloud number purchase package details.

Request

POST /api/v1/cloudNumber/purchasePackage

Request Parameters

None

Response Parameters

Parameter	Type	Description
type	integer	Number type: 1 for physical number, 0 for virtual number
name	string	Number type name
country	array	List of countries/regions supported by the current number type

country

Parameter	Type	Description
region	string	Country/region code, e.g. US, GB
name	string	Country/region name
durations	array	List of purchasable duration packages for the specified number type and country/region

durations

Parameter	Type	Description
name	string	Package duration name
days	integer	Package purchase duration, in days
gif_days	integer	Fixed number of bonus days included with the package
random_gif_days	string	Random bonus days configuration, e.g. 0-3; an empty string indicates no bonus days
is_special_offer	integer	Whether the package is a special offer: 1 for yes, 0 for no
price	number	Package price, excluding the card activation fee
card_price	number	Card activation fee
total_price	number	Total initial purchase price for a single number

Response Example

json Copy

{
    "code": 200,
    "data": [
        {
            "type": 0,
            "name": "VOIP",
            "country": [
                {
                    "region": "US",
                    "name": "US",
                    "durations": [
                        {
                            "name": "30 days",
                            "days": 30,
                            "gif_days": 0,
                            "random_gif_days": "25-50",
                            "is_special_offer": 0,
                            "price": 4.9,
                            "card_price": 0,
                            "total_price": 4.9
                        }
                    ]
                }
            ]
        },
        {
            "type": 1,
            "name": "Non-VOIP",
            "country": [
                {
                    "region": "US",
                    "name": "US",
                    "durations": [
                        {
                            "name": "29 days",
                            "days": 29,
                            "gif_days": 0,
                            "random_gif_days": "",
                            "is_special_offer": 1,
                            "price": 13.47,
                            "card_price": 0,
                            "total_price": 13.47
                        },
                        {
                            "name": "30 days",
                            "days": 30,
                            "gif_days": 0,
                            "random_gif_days": "",
                            "is_special_offer": 0,
                            "price": 19.9,
                            "card_price": 2.9,
                            "total_price": 22.8
                        },
                        {
                            "name": "360 days",
                            "days": 365,
                            "gif_days": 5,
                            "random_gif_days": "",
                            "is_special_offer": 0,
                            "price": 191.04,
                            "card_price": 2.9,
                            "total_price": 193.94
                        }
                    ]
                }
            ]
        }
    ],
    "message": "Success"
}

Cloud Number SMS

Cloud Number Package Durations Details

Last modified: 2026-08-24Powered by

Outline