Skip to main content

Determine Virtual Port Price

Determine the costs of a virtual port.

Prerequisites

  1. Authenticate - Submit your user credentials, Client ID, and Client Secret for OAuth2 authentication. Refer to API Authentication for instructions on how to call OAuth API to validate and authenticate your credentials.

  2. Get Attribute Information. Use the Get All Metros endpoint to find all metros where Equinix Fabric is available and determine port location you are pricing.

Retrieve Pricing Information

To retrieve port price estimates, send a POST request to the /fabric/v4/prices/search endpoint. Send your pricing criteria in the body of the request.

POST /fabric/v4/prices/search
MethodPOST
URL or Endpoint/fabric/v4/prices/search
HeadersAuthorization, Content-Type
Path ParametersNot applicable
Query ParametersNot applicable
Body Parametersfilter

Sample cURL Request:

curl -X POST 'https://api.equinix.com/fabric/v4/prices/search'  
-H 'content-type: application/json'
-H 'authorization: Bearer <token>'
-d '{
    "filter": {
        "and": [
            {
                "property": "/type",
                "operator": "=",
                "values": [
                    "VIRTUAL_PORT_PRODUCT"
                ]
            },
            {
                "property": "/account/accountNumber",
                "operator": "=",
                "values": [
                    270001
                ]
            },
            {
                "property": "/port/location/ibx",
                "operator": "=",
                "values": [
                    "DA1"
                ]
            },
            {
                "property": "/port/type",
                "operator": "=",
                "values": [
                    "XF_PORT"
                ]
            },
            {
                "property": "/port/bandwidth",
                "operator": "=",
                "values": [
                    1000
                ]
            },
            {
                "property": "/port/settings/buyout",
                "operator": "=",
                "values": [
                    false
                ]
            },
            {
                "property": "/port/serviceType",
                "operator": "=",
                "values": [
                    "EPL"
                ]
            },
            {
                "property": "/port/connectivitySource/type",
                "operator": "=",
                "values": [
                    "COLO"
                ]
            },
            {
                "property": "/port/lag/enabled",
                "operator": "=",
                "values": [
                    false
                ]
            }
        ]
    }
}'

Sample Response:

{  
"data": [
    {
    "type": "VIRTUAL_PORT_PRODUCT",
    "code": "ECX00001.PROD",
    "name": "Equinix Fabric Port Product",
    "description": "Equinix Fabric Port",
    "account": {
        "accountNumber": 270001
    },
    "charges": [
        {
        "type": "MONTHLY_RECURRING",
        "price": 100.0
        },
        {
        "type": "NON_RECURRING",
        "price": 500.0
        }
    ],
    "currency": "USD",
    "port": {
        "type": "XF_PORT",
        "location": {
        "ibx": "DA1"
        },
        "lag": {
        "enabled": false
        },
        "physicalPortsQuantity": 1,
        "bandwidth": 1000,
        "connectivitySource": {
        "type": "COLO"
        },
        "serviceType": "EPL",
        "settings": {
        "buyout": false
        }
    }
    }
],
"pagination": {
    "offset": 0,
    "limit": 1,
    "total": 1
}
}