Determine IP Block Price
Determine costs of an IP block in a specified location.
IP block is an Equinix-allocated set of public IP addresses that can be used for on-premises resource configuration, firewall configuration or NAT to cloud service providers (CSP).
Step 1: Authenticate
Submit your user credentials, Client ID, and Client Secret for OAuth2 authentication.
Refer to Generating Client ID and Client Secret under the Getting Access Token section for instructions on how to create client ID and client secret and refer to Requesting Access and Refresh tokens section for instructions on how to call Oauth API to validate and authenticate your credentials.
If you are unaware of your user credentials for Equinix Fabric, contact your local Equinix Service Desk.
Step 2: Get Attribute Information
Use the Get All Metros API request to find all metros where Equinix Fabric is available and determine connection origin location.
Step 3: Retrieve Pricing Information
Use the POST /fabric/v4/prices/search API request to retrieve IP block price estimates using pre-determined values.
| 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 |
Sample curl request - pricing information for an IP block
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": [
"IP_BLOCK_PRODUCT"
]
},
{
"property": "/ipBlock/type",
"operator": "=",
"values": [
"IPv4"
]
},
{
"property": "/ipBlock/prefixLength",
"operator": "=",
"values": [
29
]
},
{
"property": "/ipBlock/location/metroCode",
"operator": "IN",
"values": [
"SV", "WA"
]
}
]
}
}'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 | /ipBlock/type
/ipBlock/prefixLength /ipBlock/location/metroCode |
Search field parameter. |
| operator | yes | string | = | = IN |
Search field parameter operator. |
| values | yes | array[string] | ["IP_BLOCK_PRODUCT"] | IP_BLOCK_PRODUCT | Search field parameter value. |
| /type | yes |
"property": "/type", "operator": "=", "values": [ "IP_BLOCK_PRODUCT" ] |
Product type. | ||
| operator | yes | string | = | = | Search field parameter operator. |
| values | yes | array[string] | ["IP_BLOCK_PRODUCT"] | IP_BLOCK_PRODUCT | - |
| /account/accountNumber | no |
"property": "/account/accountNumber", "operator": "=", "values": [ 270001 ] |
Billing account number. | ||
| operator | yes | string | = | = | Search field parameter operator. |
| values | yes | array[integer] |
[270001] |
- | - |
| /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. |
- |
Sample response
{
"data": [
{
"type": "IP_BLOCK_PRODUCT",
"code": "ECX00005.PROD",
"name": "Equinix Fabric IP Addressing Product",
"description": "Equinix Fabric IP Addressing",
"charges": [
{
"type": "MONTHLY_RECURRING",
"price": 20.0
}
],
"currency": "USD",
"ipBlock": {
"type": "IPv4",
"prefixLength": 29,
"location": {
"metroCode": "SV"
}
}
},
{
"type": "IP_BLOCK_PRODUCT",
"code": "ECX00005.PROD",
"name": "Equinix Fabric IP Addressing Product",
"description": "Equinix Fabric IP Addressing",
"charges": [
{
"type": "MONTHLY_RECURRING",
"price": 160.0
}
],
"currency": "PLN",
"ipBlock": {
"type": "IPv4",
"prefixLength": 29,
"location": {
"metroCode": "WA"
}
}
}
],
"pagination": {
"offset": 0,
"limit": 2,
"total": 2
}
}Response payload body description
| Field Name | Data Type | Example Values | Description |
| type | string | IP_BLOCK_PRODUCT | Product type. |
|
code |
string | ECX00005.PROD | Product code. |
|
name |
string | Equinix Fabric IP Addressing Product | Product name. |
|
description |
string | Equinix Fabric IP Addressing | Product description. |
| charges | array[object] | — | List of product offerings with properties and prices. |
| currency | string | USD | Product offering price currency. |
| ipBlock | object | — | IP block information. |
| charges | |||
| type | string | MONTHLY_RECURRING | Charge type. |
| price | number | 20.0 | Offering price. |
| ipBlock | |||
| type | string | IPv4 |
IP addressing block type. IPv4 - IP version 4 addressing. |
|
prefixLength |
integer | 29 | The number of bits in the IP address that identify the network. |
| location | object | — | Location information. |
| ipBlock.location | |||
| metroCode | string | SV | Metropolitan area identifier. |
| 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 "Access Denied" error, contact your local Equinix Service Desk for Equinix Fabric Portal access.
