Get ports available for purchase

Get a list of available ports for purchase.

Request

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

Optional GET request parameters

datacentre_id Description The ID of the datacentre where the ports are located. datacentre_id provided in the Datacentre Locality API
Type Integer
Example 15
city_id Description The ID of the city where the ports are located. city_id provided in the Cities Locality API
Type Integer
Example 142
continent_id Description The ID of the continent where the ports are located. continent_id provided in the Continents Locality API
Type Integer
Example 3

Response

Example:

                                
{
    "ports": [
        {
            "id": 12345,
            "type": "1Gbit",
            "price": 532.65,
            "currency": "GBP",
            "datacentre": {
                "id": 543,
                "name": "Telehouse North",
                "city":{
                    "id": 43,
                    "name": "London",
                    "country": {
                        "id": 3,
                        "name": "United Kingdom",
                        "continent":{
                            "name": "EMEA"
                        }
                    }
                }
            }
        },
        ...
}
                                
                            
id Description The ID of the port.
Type Integer
Example 12345
type Description The type (capacity) of the port
Type String
Example 1Gbit
price Description The price for purchasing the port. Currency determined by the currency field
Type Float
Example 532.65
currency Description The ISO code for the currency relating to the associated price field
Type String
Example GBP
datacentre Description Object describing the Datacentre where the port is located
Type Object
Example Object definitions can be found on the Datacentre Locality API page

Back to top