Menu

Cloud Number Renewal Package Details

Usage Instructions

Retrieve the available renewal package durations for cloud numbers. If the returned duration list is empty, it means that cloud numbers of the specified region and type do not support renewal.

Request Instructions

  • Method: POST
  • Endpoint: /api/v1/cloudNumber/renewalPackage

Request Parameters

Parameter Type Required Description
number_ids array Yes Cloud number IDs. These can be obtained from the Cloud Number List endpoint.

Request Example

json Copy 
{
    "number_ids": [
        "xxxx",
        "xxxx"
    ]
}

Response Parameters

Parameter Type Description
id string Cloud number ID
phone_number string Cloud number
expired_at string Expiration time of the cloud number, Unix timestamp (seconds)
duration array Supported renewal durations.

Response Example

json Copy 
{
    "code": 200,
    "data": {
        "numbers": [
            {
                "id": "xxxxx",
                "phone_number": "+150xxxxxxxx",
                "expired_at": "1849316235",
                "duration": [
                    30,
                    180,
                    365
                ]
            },
            {
                "id": "xxxxx",
                "phone_number": "+150xxxxxxxx",
                "expired_at": "1789294999",
                "duration": [
                    29,
                    90
                ]
            }
        ]
    },
    "message": "Success"
}
Previous
Purchase Cloud Numbers
Next
Renew Cloud Numbers
Last modified: 2026-06-10Powered by