Prices

Retrieve Pricing

POST /fabric/v4/prices/search
Method POST
URL or Endpoint /fabric/v4/prices/search
Headers Authorization, Content-Type
Path Parameters Not applicable
Query Parameters Not applicable
Body Parameters filter

This API request retrieves pricing information for a specified product.

Refer to one of the following for specific use case examples:

For instructions on how to obtain an authorization token, refer to Requesting Access and Refresh Tokens.


Sample curl request - pricing information for a connection between a colocation port and a service profile

Copy 
curl -X POST 'http://api.equinix.com/fabric/v4/prices/search'
-H 'content-type: application/json'
-H 'authorization: Bearer qwErtY8zyW1abcdefGHI'
-d '{
    "filter": {
        "and": [
            {
                "property": "/type",
                "operator": "=",
                "values": [
                    "VIRTUAL_CONNECTION_PRODUCT"
                ]
            },
            {
                "property": "/connection/type",
                "operator": "=",
                "values": [
                    "EVPL_VC"
                ]
            },
            {
                "property": "/connection/bandwidth",
                "operator": "IN",
                "values": [
                    50,
                    1000
                ]
            },
            {
                "property": "/connection/aSide/accessPoint/type",
                "operator": "=",
                "values": [
                    "COLO"
                ]
            },
            {
                "property": "/connection/aSide/accessPoint/location/metroCode",
                "operator": "=",
                "values": [
                    "CH"
                ]
            },
            {
                "property": "/connection/aSide/accessPoint/port/settings/buyout",
                "operator": "=",
                "values": [
                    false
                ]
            },
            {
                "property": "/connection/zSide/accessPoint/location/metroCode",
                "operator": "=",
                "values": [
                    "DC"
                ]
            },
            {
                "property": "/connection/zSide/accessPoint/type",
                "operator": "=",
                "values": [
                    "SP"
                ]
            },
            {
                "property": "/connection/zSide/accessPoint/profile/uuid",
                "operator": "=",
                "values": [
                    "e0346949-00af-480b-801b-bdd2b8980c6e"
                ]
            }
        ]
    }
}'  

Body parameters

Parameter Name Mandatory Data Type Example Applicable Values Description
filter yes object — — Array of objects defining search conditions.
and yes array[object] — — Logical operator.
property yes string /type /type
/account/accountNumber
/connection/type
/connection/bandwidth
/connection/aSide/accessPoint/type
/connection/aSide/accessPoint/location/metroCode
/connection/aSide/accessPoint/port/settings/buyout
/connection/zSide/accessPoint/location/metroCode
/connection/zSide/accessPoint/type
/connection/zSide/accessPoint/profile/uuid
/connection/zSide/accessPoint/bridge/package/code

/ipBlock/type
/ipBlock/prefixLength
/ipBlock/location/metroCode

/router/location/metroCode
/router/package/code

/port/location/ibx
/port/type
/port/bandwidth
/port/settings/buyout
/port/connectivitySource/type
/port/serviceType
/port/lag/enabled 		Search field parameter. Note that the property value determines the list of applicable operators and values.
operator yes string = =
IN		 Search field parameter operator.
values yes array[string] ["VIRTUAL_CONNECTION_PRODUCT"] VIRTUAL_CONNECTION_PRODUCT
IP_BLOCK_PRODUCT
CLOUD_ROUTER_PRODUCT
VIRTUAL_PORT_PRODUCT 		Search field parameter value.
/type yes "property": "/type",
"operator": "=",
"values": [
"VIRTUAL_CONNECTION_PRODUCT"
] 		Product type.

Note that the product type determines the properties required to retrieve pricing information.
operator yes string = = Search field parameter operator.
values yes array[string] ["VIRTUAL_CONNECTION_PRODUCT"] VIRTUAL_CONNECTION_PRODUCT
IP_BLOCK_PRODUCT
CLOUD_ROUTER_PRODUCT
VIRTUAL_PORT_PRODUCT 		-
/account/accountNumber conditional "property": "/account/accountNumber",
"operator": "=",
"values": [
270001
] 		Billing account number.

Mandatory for port pricing.
operator yes string = = Search field parameter operator.
values yes array[integer]

[270001]

 - -


Connection product specific properties

/connection/type yes "property": "/connection/type",
"operator": "=",
"values": [
"EVPL_VC"
] 		Connection type.

Note that the connection type determines the A-side and the Z-side endpoints' properties.
operator yes string = = Search field parameter operator.
values yes array[string] ["EVPL_VC"] EVPL_VC
IP_VC
VD_CHAIN_VC		 EVPL_VC - Ethernet virtual private line‒virtual connection.
IP_VC - Fabric Cloud Router virtual connection.
VD_CHAIN_VC - Device link connection between Network Edge virtual devices.
/connection/bandwidth yes "property": "/connection/bandwidth",
"operator": "IN",
"values": [
200,
500
] 		Connection bandwidth (Mbps).
operator yes string IN IN Search field parameter operator.
values yes array[integer] [200, 500] 50
200
500
1000
2000
5000
10000		 -
/connection/aSide /accessPoint/type yes "property": "/connection/aSide/accessPoint/type",
"operator": "=",
"values": [
"COLO"
] 		Type of access point.
operator yes string = = Search field parameter operator.
values yes array[string] ["COLO"]
 COLO
CLOUD_ROUTER
VD		 COLO - Colocation space in an IBX data center.
CLOUD_ROUTER - Fabric Cloud Router instance.
VD - Network Edge virtual device.
/connection/aSide /accessPoint/location/metroCode required "property": "/connection/aSide/accessPoint/location/metroCode",
"operator": "=",
"values": [
"CH"
] 		Metropolitan area identifier.
operator yes string = = Search field parameter operator.
values yes array[string] ["CH"]

Use the Get All Metros API request to retrieve the list of metros.

-

/connection/aSide /accessPoint/port/settings/buyout

no
"property": "/connection/aSide/accessPoint/port/settings/buyout",
"operator": "=",
"values": [
false
] 		Buyout (true) or standard (false) configuration of the port at this access point. Buyout ports offer free unlimited connections. Standard ports do not.
operator yes string = = Search field parameter operator.
values yes array[boolean] [false] true
false

Default: false		 -

/connection/zSide /accessPoint/location/metroCode

no "property": "/connection/zSide/accessPoint/location/metroCode",
"operator": "=",
"values": [
"CH"
] 		Metropolitan area identifier.
operator yes string = = Search field parameter operator.
values yes array[string] ["SV"]

Use the Get All Metros API request to retrieve the list of metros.

-
/connection/zSide /accessPoint/type yes {
"property": "/connection/zSide/accessPoint/type",
"operator": "=",
"values": [
"SP"
]
} 		Type of access point.
operator yes string = = Search field parameter operator.
values yes array[string] ["SP"] CHAINGROUP
COLO
SP		 CHAINGROUP - Device link group.
COLO - Colocation space in an IBX data center.
SP - Service profile.
/connection/zSide /accessPoint/profile/uuid contitional "property": "/connection/zSide/accessPoint/profile/uuid",
"operator": "=",
"values": [
"20d32a80-0d61-4333-bc03-707b591ae2f2"
] 		Equinix-assigned service profile identifier.

Required for the SP access point type.
operator yes string = = Search field parameter operator.
values yes array[string] ["20d32a80-0d61-4333-bc03-707b591ae2f2"] - -
/connection/zSide /accessPoint/bridge/package/code conditional "property": "/connection/zSide/accessPoint/bridge/package/code",
"operator": "=",
"values": [
"GLOBAL"
] 		Connection bridge package code.

Required for the CHAINGROUP access point type.
operator yes string = =
values yes array[string] ["GLOBAL"] GLOBAL
REGIONAL		 GLOBAL - across all regions/metros.
REGIONAL - within a region.
LOCAL - within a metro

IP block product specific properties
/ipBlock/type yes "property": "/ipBlock/type",
"operator": "=",
"values": [
"IPv4"
] 		IP addressing block type.
operator yes string = = Search field parameter operator.
values yes array[string] ["IPv4"] IPv4 IPv4- IP version 4 addressing.
/ipBlock/prefixLength yes "property": "/ipBlock/prefixLength",
"operator": "=",
"values": [
29
] 		The number of bits in the IP address that identify the network.
operator yes string = = Search field parameter operator.
values yes array[integer] [29] 29 -
/ipBlock/location/metroCode yes "property": "/ipBlock/location/metroCode",
"operator": "IN",
"values": [
"SV", "WA", "AM"
]
Metropolitan area identifier.
operator yes string IN IN Search field parameter operator.
values yes array[string] ["SV", "WA", "AM"]

Use the Get All Metros API request to retrieve the list of metros.

-

Fabric Cloud Router product specific properties
/router/location/metroCode yes "property": "/router/location/metroCode",
"operator": "=",
"values": [
"SV"
] 		Metropolitan area identifier.
operator yes string = = Search field parameter operator.
values yes array[string] ["SV"]

Use the Get All Metros API request to retrieve the list of metros.

-
/router/package/code yes "property": "/router/package/code",
"operator": "IN",
"values": [
"LAB", "STANDARD"
]

Fabric Cloud Router package identifier.
operator yes string IN IN Search field parameter operator.
values yes array[string] ["LAB", "STANDARD"] LAB
STANDARD

LAB - Max Routes IPv4 = 50, Max Routes IPv6 = 50; 10Mbps max per connection ingress/egress bandwidth limit; Max connections per FCR: 10 (Trial package)

STANDARD - Max Routes IPv4 = 1000, Max Routes IPv6 = 100.


Virtual Port product specific properties
/port/location/ibx yes "property": "/port/location/ibx",
"operator": "=",
"values": [
"WA1"
] 		Equinix IBX data center identifier.
operator yes string = = Search field parameter operator.
values yes array[string] ["WA1"]

Use the Get All Metros API request to retrieve the list of metros.

-
/port/type yes "property": "/port/type",
"operator": "=",
"values": [
"XF_PORT"
] 		Type of port.
operator yes string = = Search field parameter operator.
values yes array[string] ["XF_PORT"] XF_PORT XF_PORT - Equinix Fabric port used as a Fabric connection endpoint.
/port/bandwidth yes "property": "/port/bandwidth",
"operator": "=",
"values": [
1000
] 		Port bandwidth in Mbps.
operator yes string = = Search field parameter operator.
values yes array[integer] [1000] 1000
10000
100000		 -
/port/settings/buyout no "property": "/port/settings/buyout",
"operator": "=",
"values": [
false
] 		Buyout (true) or standard (false) configuration of the port at this access point. Buyout ports offer free, unlimited connections. Standard ports do not.
operator yes string = = Search field parameter operator.
values yes array[boolean] [false] false
true

Default: false		 -
/port/connectivitySource/type no "property": "/port/connectivitySource/type",
"operator": "=",
"values": [
"COLO"
] 		Port connectivity source type.
operator yes string = = Search field parameter operator.
values yes array[string] ["COLO"] BMMR
COLO
REMOTE

Default: COLO		 BMMR - Building's Meet Me Room available in one of the multitenant data centers.
COLO - Colocation space in an Equinix IBX data center.
REMOTE - Remote ports enable access to Equinix Fabric services through a third party such as an NSP.
/port/serviceType no "property": "/port/serviceType",
"operator": "=",
"values": [
"MSP"
] 		Port service type.
operator yes string = = Search field parameter operator.
values yes array[string] ["MSP"] EPL
MSP

Default: MSP		 EPL - Ethernet Private Line port for untagged, EPL connections.
MSP - Managed service port.
/port/lag/enabled no "property": "/port/lag/enabled",
"operator": "=",
"values": [
false
] 		Indicator showing if a port can be part of a link aggregation group.
operator yes string = = Search field parameter operator.
values yes array[boolean] [false] false
true

Default: false		 -

Sample response

Copy 
{
    "data": [
        {
            "type": "VIRTUAL_CONNECTION_PRODUCT",
            "code": "ECX00015.PROD",
            "name": "Equinix Fabric Virtual Connection Product",
            "description": "Equinix Fabric Virtual Connection",
            "charges": [
                {
                    "type": "MONTHLY_RECURRING",
                    "price": 250.0
                }
            ],
            "currency": "USD",
            "connection": {
                "type": "EVPL_VC",
                "bandwidth": 50,
                "aSide": {
                    "accessPoint": {
                        "type": "COLO",
                        "location": {
                            "metroCode": "CH"
                        }
                    }
                },
                "zSide": {
                    "accessPoint": {
                        "type": "SP",
                        "location": {
                            "metroCode": "DC"
                        },
                        "profile": {
                            "uuid": "e0346949-00af-480b-801b-bdd2b8980c6e"
                        }
                    }
                }
            }
        },
        {
            "type": "VIRTUAL_CONNECTION_PRODUCT",
            "code": "ECX00015.PROD",
            "name": "Equinix Fabric Virtual Connection Product",
            "description": "Equinix Fabric Virtual Connection",
            "charges": [
                {
                    "type": "MONTHLY_RECURRING",
                    "price": 900.0
                }
            ],
            "currency": "USD",
            "connection": {
                "type": "EVPL_VC",
                "bandwidth": 1000,
                "aSide": {
                    "accessPoint": {
                        "type": "COLO",
                        "location": {
                            "metroCode": "CH"
                        }
                    }
                },
                "zSide": {
                    "accessPoint": {
                        "type": "SP",
                        "location": {
                            "metroCode": "DC"
                        },
                        "profile": {
                            "uuid": "e0346949-00af-480b-801b-bdd2b8980c6e"
                        }
                    }
                }
            }
        }
    ],
    "pagination": {
        "offset": 0,
        "limit": 2,
        "total": 2
    }
}

Response body description

Field Name Data Type Example Values Description
type string VIRTUAL_CONNECTION_PRODUCT Product type.

code

 string ECX00015.PROD Product code.

name

 string Equinix Fabric Virtual Connection Product Product name.

description

 string Equinix Fabric Virtual Connection Product description.
account object — Customer billing account information.
charges array[object] — List of product offerings with properties and prices.
currency string USD Product offering price currency.
conenction object — Connection information.
account
accountNumber string 270001 Billing account number.
charges
type string MONTHLY_RECURRING Charge type.
price number 900.0 Offering price.
connection
type string EVPL_VC Connection type.

bandwidth

 integer 1000 Connection bandwidth (Mbps).
aSide/zSide object — An A-Side (subscriber) or Z-side (provider) connection configuration.
aSide/zSide
accessPoint object — Carrier-neutral network hub for interconnectivity among global internet access providers.
aSide/zSide.accessPoint
type string SP Type of access point.
location object — Attributes associated with the location of the specified connection.
aSide/zSide.accessPoint.location
metroCode string CH Code assigned to an Equinix International Business Exchange (IBX) data center in a specified metropolitan area.
pagination
offset integer 0 Index of the first item returned in the response.
limit integer 2 Maximum number of items returned per page.
total integer 2 Total number of items that match request criteria.

If you get an "Access Denied" error, contact your local Equinix Service Desk for Equinix Fabric Portal access.