Available numbers in a country

Request available numbers to reserve to your account in a specified country.

Request

Endpoint: /api/available_numbers/country/{country_code}
Example: /api/available_numbers/country/uk
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
number_service_type Description The code representing the Number Service Type. Permitted values; GEOGRAPHIC, TOLL FREE, PREMIUM, MOBILE
Type String
Example GEOGRAPHIC
in_country_termination Description Whether the number supports In Country Termination. Also changes the pricing applicably for the feature.
Type Boolean (default false)
Example true
emergency_address_registration Description Whether the number supports registration of an Emergency Address. Also changes the pricing applicably for the feature. This feature is only available when an outbound service is also specified (e.g. In Country Termination).
Type Boolean (default false)
Example true

Response

Example:

                                
    {
        "available_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": "Available"
            },
        ],
        "num_results": 31,
        "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
country_iso Description The ISO code for the country
Type String
Example UK
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
status Description The status of the number
Type String
Example Available
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