1. Numbers
  3. API Documentation
  4. Cancelled Numbers That Were Previously in your Account

Cancelled numbers that were previously in your account

List of numbers that were previously in your account and have since been cancelled.

Request

Endpoint: /api/numbers/cancelled
Method: GET
Headers: Accept: application/vnd.cloudlx.v1+json
Authorization: Bearer <access_token>

Optional GET request parameters

search Description The number must contain these digits
Type Integer
Example 123
max_per_page Description Limit the number of results returned (max 200)
Type Integer
Example 50
page Description The page number, if the number of results exceeds max_per_page
Type Integer
Example 2

Response

Example:

                                
    {
        "numbers": [
            {
                "uuid": "84436b07-5aa7-481e-bc04-86b7a425b54c",
                "number_e164": "+441245123456",
                "number": "123456",
                "range_code": "1245",
                "range_name": "Chelmsford",
                "country_code": "44",
                "country_name": "United Kingdom",
                "country_iso": "UK",
                "monthly_charge": 0.3,
                "setup_charge": 0,
                "status": "Cancelled",
                "provisioned": "2016-01-04 11:26:50",
                "cancelled": "2016-01-04 11:27:00"
            }
        ],
        "num_results": 1,
        "paginates": false
    }
uuid Description The uuid for the number, used to perform actions on the number
Type String
Example 84436b07-5aa7-481e-bc04-86b7a425b54c
number_e164 Description The E.164 representation of the number
Type String
Example +441245123456
number Description The local number
Type String
Example 123456
range_code Description The range code for the number
Type String
Example 1245
range_name Description The range name, such as number type or area code
Type String
Example Chelmsford
country_code Description The country dialling code for the number
Type String
Example 44
country_name Description The country name for the number
Type String
Example United Kingdom
monthly_charge Description The monthly cost for the number
Type String
Example 0.3
setup_charge Description The once off setup cost for the number
Type String
Example 0
country_iso Description The ISO code for the country
Type String
Example UK
status Description The status of the number
Type String
Example Cancelled
provisioned Description The timestamp the number was provisioned to your account
Type Timestamp
Example 2016-01-03 17:48:59
cancelled Description The timestamp the number was removed from your account
Type Timestamp
Example 2016-01-04 11:27:00
num_results Description The total number of results returned
Type Integer
Example 10
paginates Description Whether or not the number of results exceeds the maximum number of results specified
Type Boolean
Example false

Back to top