Skip to main content

Effective 10 September 2024, API Documentation can be found on our Equinix Product Documentation site.
The content on this page will not be updated after 1 Oct 2024 and will be inaccessible after 31st Dec 2024.


Prices

Retrieve Pricing​

 POST /internetAccess/v1/prices/search
MethodPOST
Endpoint/internetAccess/v1/prices/search
HeadersAuthorization, Content-Type
Path ParametersNot applicable
Query Parametersoffset, limit
Body Parametersfilter, and, property, operator, values

This API request retrieves pricing information for a specified Equinix Internet Access configuration. The currency is determined by the billing account settings. If a product or its part is provided free of charge, it's listed with the price parameter value of 0.

 

The Pricing Information obtained using the Get Pricing API request: (1) is calculated pursuant to the Master Country Agreement, Pricing Agreement, or other similar agreement (“Agreement”) effective between Equinix and Customer; and (2) does not include taxes and may vary depending upon the options selected by Customer in the Order and the applicable tax jurisdiction.


Sample curl request - Equinix Internet Access pricing

curl -X POST 'https://api.equinix.com/internetAccess/v1/prices/search'
-H 'content-type: application/json'
-H 'authorization: Bearer qwErtY8zyW1abcdefGHI'
-d '{
    "filter": {
        "and": [
            {
                "property": "/type",
                "operator": "=",
                "values": [
                    "INTERNET_ACCESS_PRODUCT"
                ]
            },
            {
                "property": "/account/accountNumber",
                "operator": "=",
                "values": [
                    "123456"
                ]
            },
            {
                "property": "/service/type",
                "operator": "=",
                "values": [
                    "SINGLE_PORT"
                ]
            },
            {
                "property": "/service/useCase",
                "operator": "=",
                "values": [
                    "MAIN"
                ]
            },
            {
                "property": "/service/billing",
                "operator": "=",
                "values": [
                    "FIXED"
                ]
            },
            {
                "property": "/service/connection/type",
                "operator": "=",
                "values": [
                    "IA_C"
                ]
            },
            {
                "property": "/service/connection/aSide/accessPoint/type",
                "operator": "=",
                "values": [
                    "COLO"
                ]
            },
            {
                "property": "/service/connection/aSide/accessPoint/location/ibx",
                "operator": "=",
                "values": [
                    "DC5"
                ]
            },
            {
                "property": "/service/connection/aSide/accessPoint/port/physicalPort/speed",
                "operator": "=",
                "values": [
                    10000
                ]
            },
            {
                "property": "/service/connection/aSide/accessPoint/port/physicalPortQuantity",
                "operator": "=",
                "values": [
                    1
                ]
            },
            {
                "property": "/service/routingProtocol/type",
                "operator": "=",
                "values": [
                    "BGP"
                ]
            },
            {
                "property": "/service/routingProtocol/ipv4/customerRoute/ipBlock/prefixLength",
                "operator": "=",
                "values": [
                    28
                ]
            },
            {
                "property": "/service/routingProtocol/ipv6/customerRoute/ipBlock/prefixLength",
                "operator": "=",
                "values": [
                    48
                ]
            }
        ]
    }
}'

Sample curl request - IP block pricing

curl -X POST 'https://api.equinix.com/internetAccess/v1/prices/search'
-H 'content-type: application/json'
-H 'authorization: Bearer qwErtY8zyW1abcdefGHI'
-d '{
    "filter": {
        "and": [
            {
                "property": "/type",
                "operator": "=",
                "values": [
                    "IP_BLOCK_PRODUCT"
                ]
            },
            {
                "property": "/ipBlock/type",
                "operator": "=",
                "values": [
                    "IA_IP_BLOCK"
                ]
            },
            {
                "property": "/account/accountNumber",
                "operator": "=",
                "values": [
                    "123456"
                ]
            },
            {
                "property": "/ipBlock/location/ibx",
                "operator": "=",
                "values": [
                    "DC5"
                ]
            },
            {
                "property": "/ipBlock/ipv4/prefixLength",
                "operator": "=",
                "values": [
                    28
                ]
            }
        ]
    }
}

Query parameters

Parameter
Description
offset integer
OPTIONAL		Index of the first item returned in the response.
Default value: 0
limit integer
OPTIONAL		Maximum number of items returned per page.
Default value: 50

Body parameters

Parameter
Description
filter object
REQUIRED		Object defining search conditions.
and array[object]
REQUIRED
Array of search parameters.
property string
REQUIRED
Search field parameter.
Applicable values:
  • /type
  • /account/accountNumber
  • /service/type
  • /service/useCase
  • /service/bandwidth
  • /service/billing
  • /service/connection/type
  • /service/connection/aSide/accessPoint/type
  • /service/connection/aSide/accessPoint/location/ibx
  • /service/connection/aSide/accessPoint/port/physicalPort/speed
  • /service/connection/aSide/accessPoint/port/physicalPortQuantity
  • /service/routingProtocol/type
  • /service/routingProtocol/ipv4/customerRoute/ipBlock/prefixLength
  • /service/routingProtocol/ipv6/customerRoute/ipBlock/prefixLength
  • /service/minBandwidthCommit
  • /ipBlock/type
  • /ipBlock/location/ibx
  • /ipBlock/ipv4/prefixLength
  • /ipBlock/ipv6/prefixLength
operator string
REQUIRED
Search field parameter operator.
Applicable values: =
values array[string/integer]
REQUIRED
Search field parameter value.
Example: IA_IP_BLOCK
/typeProduct type.
Example:
"property": "/type",
"operator": "=",
"values": [
    "INTERNET_ACCESS_PRODUCT"
]
operator string
REQUIRED		Search field parameter operator.
Applicable values: =
values array[string]
REQUIRED		Search field parameter value.
Example:
  • INTERNET_ACCESS_PRODUCT
  • IP_BLOCK_PRODUCT
/account/accountNumberBilling account number.
Example:
"property": "/account/accountNumber",
"operator": "=",
"values": [
    "123456"
]
operator string
REQUIRED		Search field parameter operator.
Applicable values: =
values array[string]
REQUIRED		Search field parameter value.
Example: 123456
/service/typeService port type option. Applicable to INTERNET_ACCESS_PRODUCT product type.
Example:
"property": "/service/type",
"operator": "=",
"values": [
    "DUAL_PORT"
]
operator string
REQUIRED		Search field parameter operator.
Applicable values: =
values array[string]
REQUIRED		Search field parameter value.
Applicable values:
  • SINGLE_PORT
  • DUAL_PORT
/service/useCaseInternet access use case. Applicable to INTERNET_ACCESS_PRODUCT product type.
Example:
"property": "/service/useCase",
"operator": "=",
"values": [
    "BACKUP"
]
operator string
REQUIRED		Search field parameter operator.
Applicable values: =
values array[string]
REQUIRED		Search field parameter value.
Applicable values:
  • MAIN
  • BACKUP
  • MANAGEMENT_ACCESS
/service/bandwidthConnection bandwidth in Mbps. Applicable to INTERNET_ACCESS_PRODUCT product type, FIXED and BURST_BASED billing.
Example:
"property": "/service/bandwidth",
"operator": "=",
"values": [
    1000
]
operator string
REQUIRED		Search field parameter operator.
Applicable values: =
values array[integer]
REQUIRED		Search field parameter value.
Example: 1000
/service/billingService billing type. Applicable to INTERNET_ACCESS_PRODUCT product type.
Example:
"property": "/service/billing",
"operator": "=",
"values": [
    "USAGE_BASED"
]
operator string
REQUIRED		Search field parameter operator.
Applicable values: =
values array[string]
REQUIRED		Search field parameter value.
Applicable values:
  • FIXED
  • USAGE_BASED
  • BURST_BASED
/service/connection/typeInternet access connection type. Applicable to INTERNET_ACCESS_PRODUCT product type.
Example:
"property": "/service/connection/type",
"operator": "=",
"values": [
    "IA_C"
]
operator string
REQUIRED		Search field parameter operator.
Applicable values: =
values array[string]
REQUIRED		Search field parameter value.
Applicable values:
  • IA_C - Internet Access service instance with dedicated port.
  • IA_VC - Internet Access service instance with Fabric.
/service/connection/aSide/accessPoint/typeConnection endpoint type. Applicable to INTERNET_ACCESS_PRODUCT product type.
Example:
"property": "/service/connection/aSide/accessPoint/type",
"operator": "=",
"values": [
    "COLO"
]
operator string
REQUIRED		Search field parameter operator.
Applicable values: =
values array[string]
REQUIRED		Search field parameter value.
Applicable values:
  • COLO - Colocation space in an IBX data center.
/service/connection/aSide/ accessPoint/location/ibxIBX data center identifier. Applicable to INTERNET_ACCESS_PRODUCT product type.
Example:
"property": "/service/connection/aSide/accessPoint/location/ibx",
"operator": "=",
"values": [
    "WA1"
]
operator string
REQUIRED		Search field parameter operator.
Applicable values: =
values array[string]
REQUIRED		Search field parameter value.
Applicable values: Use the Get IBX Data Centers API request to retrieve IBX data centers where Equinix Internet Access is available.
/service/connection/aSide/ accessPoint/port/physicalPort/speedPort bandwidth capacity. Applicable to INTERNET_ACCESS_PRODUCT product type.
Example:
"property": "/service/connection/aSide/accessPoint/port/physicalPort/speed",
"operator": "=",
"values": [
    10000
]
operator string
REQUIRED		Search field parameter operator.
Applicable values: =
values array[integer]
REQUIRED		Search field parameter value.
Applicable values:
  • 1000
  • 10000
  • 100000
/service/connection/aSide/ accessPoint/port/physicalPortQuantityNumber of physical ports. Applicable to INTERNET_ACCESS_PRODUCT product type.
Example:
"property": "/service/connection/aSide/accessPoint/port/physicalPortQuantity",
"operator": "=",
"values": [
    1
]
operator string
REQUIRED		Search field parameter operator.
Applicable values: =
values array[integer]
REQUIRED		Search field parameter value.
Minimum: 1
Maximum: 10
/service/routingProtocol/typeRouting protocol type. Applicable to INTERNET_ACCESS_PRODUCT product type.
Example:
"property": "/service/routingProtocol/type",
"operator": "=",
"values": [
    "BGP"
]
operator string
REQUIRED		Search field parameter operator.
Applicable values: =
values array[string]
REQUIRED		Search field parameter value.
Applicable values:
  • BGP
  • DIRECT
  • STATIC
/service/routingProtocol/ipv4/ customerRoute/ipBlock/prefixLengthIP v4 subnet size. Applicable to INTERNET_ACCESS_PRODUCT product type.
Example:
"property": "/service/routingProtocol/ipv4/customerRoute/ipBlock/prefixLength",
"operator": "=",
"values": [
    28
]
operator string
REQUIRED		Search field parameter operator.
Applicable values: =
values array[integer]
REQUIRED		Search field parameter value.
Applicable values:
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29 (applicable to BGP and STATIC routing protocols)
  • 30 (applicable to BGP and STATIC routing protocols)
/service/routingProtocol/ipv6/ customerRoute/ipBlock/prefixLengthIP v6 subnet size. Applicable to INTERNET_ACCESS_PRODUCT product type.
Example:
"property": "/service/routingProtocol/ipv6/customerRoute/ipBlock/prefixLength",
"operator": "=",
"values": [
    48
]
operator string
REQUIRED		Search field parameter operator.
Applicable values: =
values array[integer]
REQUIRED		Search field parameter value.
Applicable values:
  • 48
  • 60 (applicable to BGP and STATIC routing protocols)
/service/minBandwidthCommitMinimum bandwidth commitment. Applicable to INTERNET_ACCESS_PRODUCT product type, BURST_BASED billing.
Example:
"property": "/service/minBandwidthCommit",
"operator": "=",
"values": [
    1000
]
operator string
REQUIRED		Search field parameter operator.
Applicable values: =
values array[integer]
REQUIRED		Search field parameter value.
Applicable values:
  • 48
  • 60 (applicable to BGP and STATIC routing protocols)
/ipBlock/typeIP block type. Applicable to IP_BLOCK_PRODUCT product type.
Example:
"property": "/ipBlock/type",
"operator": "=",
"values": [
    "IA_IP_BLOCK"
]
operator string
REQUIRED		Search field parameter operator.
Applicable values: =
values array[string]
REQUIRED		Search field parameter value.
Applicable values: IA_IP_BLOCK
/ipBlock/location/ibxIBX data center identifier where the leased IP block is located. Applicable to IP_BLOCK_PRODUCT product type.
Example:
"property": "/ipBlock/location/ibx",
"operator": "=",
"values": [
    "WA1"
]
operator string
REQUIRED		Search field parameter operator.
Applicable values: =
values array[string]
REQUIRED		Search field parameter value.
Applicable values: Use the Get IBX Data Centers API request to retrieve IBX data centers where Equinix Internet Access is available.
/ipBlock/ipv4/prefixLengthIP v4 block size. Applicable to IP_BLOCK_PRODUCT product type.
Example:
"property": "/ipBlock/ipv4/prefixLength",
"operator": "=",
"values": [
    "USAGE_BASED"
]
operator string
REQUIRED		Search field parameter operator.
Applicable values: =
values array[string]
REQUIRED		Search field parameter value.
Applicable values:
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29 (applicable to BGP and STATIC routing protocols)
  • 30 (applicable to BGP and STATIC routing protocols)
/ipBlock/ipv6/prefixLengthIP v6 block size. Applicable to IP_BLOCK_PRODUCT product type.
Example:
"property": "/ipBlock/ipv6/prefixLength",
"operator": "=",
"values": [
    "USAGE_BASED"
]
operator string
REQUIRED		Search field parameter operator.
Applicable values: =
values array[string]
REQUIRED		Search field parameter value.
Applicable values:
  • 48
  • 60 (applicable to BGP and STATIC routing protocols)

Sample response - Equinix Internet Access pricing

{
    "data": [
        {
            "href": "https://api.equinix.com/internetAccess/v1/prices/search",
            "type": "INTERNET_ACCESS_PRODUCT",
            "code": "EC00015.PROD",
            "name": "Internet Access Service Product",
            "description": "Internet Access Service",
            "account": {
                "accountNumber": "123456"
            },
            "currency": "USD",
            "category": "CUSTOMER",
            "charges": [
                {
                    "type": "MONTHLY_RECURRING",
                    "price": 1750,
                    "unit": "ITEM",
                    "product": {
                        "type": "INTERNET_ACCESS_PRODUCT",
                        "code": "EC00015.PROD",
                        "name": "Internet Access Service Product",
                        "description": "Internet Access Service"
                    }
                },
                {
                    "type": "MONTHLY_RECURRING",
                    "price": 1.75,
                    "unit": "MBPS_1",
                    "product": {
                        "type": "INTERNET_ACCESS_PRODUCT",
                        "code": "EC00015.PROD",
                        "name": "Internet Access Service Product",
                        "description": "Internet Access Service"
                    }
                },
                {
                    "type": "NON_RECURRING",
                    "price": 750,
                    "unit": "ITEM",
                    "product": {
                        "type": "INTERNET_ACCESS_PRODUCT",
                        "code": "EC00015.PROD",
                        "name": "Internet Access Service Product",
                        "description": "Internet Access Service"
                    }
                }
            ],
            "summary": {
                "charges": [
                    {
                        "type": "MONTHLY_RECURRING",
                        "price": 1750,
                        "unit": "ITEM"
                    },
                    {
                        "type": "NON_RECURRING",
                        "price": 750,
                        "unit": "ITEM"
                    }
                ],
                "totalCharge": {
                    "price": 2500
                }
            },
            "service": {
                "type": "SINGLE_PORT",
                "minBandwidthCommit": 1000,
                "billing": "BURST_BASED",
                "useCase": "MAIN",
                "connection": {
                    "type": "IA_C",
                    "aSide": {
                        "accessPoint": {
                            "type": "COLO",
                            "location": {
                                "ibx": "DC5"
                            },
                            "port": {
                                "physicalPort": {
                                    "speed": 1000
                                },
                                "physicalPortQuantity": 1
                            }
                        }
                    }
                },
                "routingProtocol": {
                    "type": "BGP",
                    "ipv4": {
                        "customerRoute": {
                            "ipBlock": {
                                "prefixLength": 28
                            }
                        }
                    },
                    "ipv6": {
                        "customerRoute": {
                            "ipBlock": {
                                "prefixLength": 48
                            }
                        }
                    }
                }
            }
        }
    ],
    "pagination": {
        "offset": 0,
        "limit": 50,
        "total": 1
    }
}

Sample response - IP block pricing

{
    "data": [
        {
            "href": "https://api.equinix.com/internetAccess/v1/prices/search",
            "type": "IP_BLOCK_PRODUCT",
            "code": "EC00006.PROD",
            "name": "Internet Access IP Addressing Product",
            "description": "Internet Access IP Addressing",
            "account": {
                "accountNumber": "212179"
            },
            "currency": "USD",
            "category": "CUSTOMER",
            "charges": [
                {
                    "type": "MONTHLY_RECURRING",
                    "price": 100.8,
                    "unit": "ITEM",
                    "product": {
                        "type": "IP_BLOCK_PRODUCT",
                        "code": "EC00006.PROD",
                        "name": "Internet Access IP Addressing Product",
                        "description": "Internet Access IP Addressing"
                    }
                },
                {
                    "type": "NON_RECURRING",
                    "price": 50,
                    "unit": "ITEM",
                    "product": {
                        "type": "IP_BLOCK_PRODUCT",
                        "code": "EC00006.PROD",
                        "name": "Internet Access IP Addressing Product",
                        "description": "Internet Access IP Addressing"
                    }
                }
            ],
            "summary": {
                "charges": [
                    {
                        "type": "MONTHLY_RECURRING",
                        "price": 100.8,
                        "unit": "ITEM"
                    },
                    {
                        "type": "NON_RECURRING",
                        "price": 50,
                        "unit": "ITEM"
                    }
                ],
                "totalCharge": {
                    "price": 150.8
                }
            },
            "ipBlock": {
                "type": "IA_IP_BLOCK",
                "location": {
                    "ibx": "DC5"
                },
                "ipv4": {
                    "prefixLength": 28
                }
            }
        }
    ],
    "pagination": {
        "offset": 0,
        "limit": 50,
        "total": 1
    }
}

Response payload body description

Parameter
Description
data array[object]
Data set containing product pricing information.
href string
Pricing information endpoint URL.
type string
Product type.
Possible values:
  • INTERNET_ACCESS_PRODUCT
  • IP_BLOCK_PRODUCT
code string
Equinix-assigned product code.
Example: EC00015.PROD
name string
Full product name.
Example: Internet Access Service Product
description string
Product description.
Example: Internet Access Service
account object
Customer billing account data.
accountNumber string
Customer billing account number.
Example: 123456
currency string
Currency used for the offering price of the product.
Example: USD
category string
Price category.
Example: CUSTOMER
charges array[object]
Details about charges.
type string
Charge type.
Possible values:
  • MONTHLY_RECURRING - Monthly recurring charge.
  • NON_RECURRING - One-time fee.
price number
Offering price.
Example: 1750
unit string
Billable unit.
Possible values:
  • ITEM - Applicable to fixed price items
  • GB_1 - Gigabit
  • MBPS_1 - Megabits per second
product object
Product details.
type string
Product type.
Possible values:
  • INTERNET_ACCESS_PRODUCT
  • IP_BLOCK_PRODUCT
code string
Equinix-assigned product code.
Example: EC00015.PROD
name string
Full product name.
Example: Internet Access Service Product
description string
Product description.
Example: Internet Access Service
summary object
Summary details of charges.
charges array[object]
Details about charges.
type string
Charge type.
Possible values:
  • MONTHLY_RECURRING - Monthly recurring charge.
  • NON_RECURRING - One-time fee.
price number
Offering price.
Example: 1.75
unit string
Billable unit.
Possible values:
  • ITEM - Applicable to fixed price items
  • GB_1 - Gigabit
  • MBPS_1 - Megabits per second
totalCharge object
Total charge details.
price number
Total charge price.
Example: 2500
service object
Equinix Internet Access service instance configuration.
type string
Service type.
Possible values:
  • SINGLE_PORT - Internet access over a single connection.
  • DUAL_PORT - Internet access over two redundant connections.
bandwidth integer
Connection bandwidth in Mbps.
Note: Applicable to FIXED billing.
Example: 500
minBandwidthCommit integer
Minimum bandwidth commitment in Mbps.
Note: Applicable to BURST_BASED and USAGE_BASED billing.
Example: 500
billing string
Billing type.
Possible values:
  • FIXED
  • USAGE_BASED
  • BURST_BASED
useCase string
Service use case.
Possible values:
  • MAIN
  • BACKUP
  • MANAGEMENT_ACCESS
connection object
Connection details.
type string
Connection type.
Possible values:
  • IA_C - Internet access connection through a dedicated port.
  • IA_VC - Internet access connection through a Fabric port.
aSide object
A-side connection configuration.
accessPoint object
Access point object.
type string
Type of access point.
Possible values: COLO
location object
Geographic data for the product.
ibx string
IBX data center identifier.
Example: DC5
port object
Port associated with the connection.
physicalPort object
Physical port details.
speed integer
Physical port bandwidth capacity in Mbps.
Example: 1000
physicalPortQuantity integer
Number of physical ports.
Example: 2
routingProtocol object
Routing protocol details.
type string
Routing type.
Possible values:
  • DIRECT
  • STATIC
  • BGP
ipv4 object
Routing protocol IP block for IP v4.
customerRoute object
Customer route.
ipBlock object
Customer IP block.
prefixLength integer
The IP v4 routing prefix, or a subnet mask, is the network portion of an IP address.
Example: 29
importPolicy string
Customer route import policy.
Possible values:
  • PI - Provider independent, customer owned IP address.
  • PA - Provider assigned, IP addresses leased from Equinix.
ipv6 object
IP v6 IP block configuration.
customerRoute object
Customer route.
ipBlock object
Customer IP block.
prefixLength integer
The IP v6 routing prefix, or a subnet mask, is the network portion of an IP address.
Example: 64
importPolicy string
Customer route import policy.
Possible values:
  • PI - Provider independent, customer owned IP address.
  • PA - Provider assigned, IP addresses leased from Equinix.
ipBlock object
Configuration of the IP block to which the specified connections belong.
Note: Applicable to IP block pricing.
type string
IP Block type.
Possible values:
  • IA_IP4
  • IA_IP6
location object
Geographic data for the product.
ibx string
IBX data center identifier in which the IP block is located.
Example: DC5
ipv4/ipv6 object
IP v4/v6 subnet information.
prefixLength integer
Routing prefix, or a subnet mask, is the network portion of an IP address.
Example: 28
pagination object
Data set pagination settings.
offset integer
Index of the first item returned in the response.
limit integer
Maximum number of items returned per page.
total integer
Total number of items.