Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Equinix Interconnections API

Network Interconnections. See Instructions to create Network Interconnections at Check out the product docs to learn more about [Equinix Fabric](https://metal.equinix.com/developers/docs/networking/fabric/).

Equinix Interconnections API is one of 74 APIs that Equinix publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Interconnections. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 15 operations across 8 paths, and defines 47 schemas. It is described by OpenAPI 3.0.1, at version 1.2.

Requests are made against a single base URL, https://api.equinix.com.

15 operations 8 paths 47 schemas 2 DELETE8 GET3 POST2 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.1
API Version
1.2
Base URL
https://api.equinix.com
Terms of Service
Resource Areas
1

Paths & Operations 15

Across 8 paths, the API surfaces 15 operations — 2 DELETE, 8 GET, 3 POST, 2 PUT. Each is listed below with its method, path, parameters, and response codes.

Interconnections 15

Network Interconnections. See Instructions to create Network Interconnections at Check out the product docs to learn more about [Equinix Fabric](https://metal.equinix.com/develope…

DELETE
/connections/{connection_id}
Delete interconnection
deleteInterconnection 3 params → 202403404
GET
/connections/{connection_id}
Get interconnection
getInterconnection 3 params → 200403404
PUT
/connections/{connection_id}
Update interconnection
updateInterconnection 3 params body → 200403404
GET
/connections/{connection_id}/ports
List a interconnection's ports
listInterconnectionPorts 1 param → 200403404
GET
/connections/{connection_id}/virtual-circuits
List a interconnection's virtual circuits
listInterconnectionVirtualCircuits 1 param → 200403404
GET
/connections/{connection_id}/ports/{id}
Get a interconnection port
getInterconnectionPort 4 params → 200403404
GET
/connections/{connection_id}/ports/{port_id}/virtual-circuits
List a interconnection port's virtual circuits
listInterconnectionPortVirtualCircuits 4 params → 200403404
POST
/connections/{connection_id}/ports/{port_id}/virtual-circuits
Create a new Virtual Circuit
createInterconnectionPortVirtualCircuit 2 params body → 201403404
GET
/organizations/{organization_id}/connections
List organization connections
organizationListInterconnections 3 params → 200403404
POST
/organizations/{organization_id}/connections
Request a new interconnection for the organization
createOrganizationInterconnection 3 params body → 201403404422
GET
/projects/{project_id}/connections
List project connections
projectListInterconnections 5 params → 200403404
POST
/projects/{project_id}/connections
Request a new interconnection for the project's organization
createProjectInterconnection 3 params body → 201403422
DELETE
/virtual-circuits/{id}
Delete a virtual circuit
deleteVirtualCircuit 3 params → 202403404
GET
/virtual-circuits/{id}
Get a virtual circuit
getVirtualCircuit 3 params → 200403404
PUT
/virtual-circuits/{id}
Update a virtual circuit
updateVirtualCircuit 3 params body → 200202403404

Schemas 47

The contract defines 47 schemas that model the data the API accepts and returns. The most detailed are User (22 properties), Interconnection (19 properties), Project (19 properties), VrfVirtualCircuit (18 properties). Each schema is shown below with its type and property counts.

VlanFabricVcCreateInput_service_token_type
string
Either 'aside' or 'zside'. Setting this field to 'aside' will create an interconnection with Fabric VCs (Metal Billed). Setting this field to 'zside' will crea…
VrfVirtualCircuit_status
string
The status changes of a VRF virtual circuit are generally the same as Virtual Circuits that aren't in a VRF. However, for VRF Virtual Circuits on Fabric VCs, t…
VlanVirtualCircuit
object
15 properties
DedicatedPortCreateInput
object
12 properties 4 required
Meta
object
8 properties
VirtualCircuitUpdateInput
Interconnection_mode
string
The mode of the interconnection (only relevant to Dedicated Ports). Shared connections won't have this field. Can be either 'standard' or 'tunnel'. The default…
InterconnectionPort_role
string
Either 'primary' or 'secondary'.
VrfVirtualCircuit
object
18 properties 1 required
Address
object
7 properties 3 required
InterconnectionPort_status
string
For both Fabric VCs and Dedicated Ports, this will be 'requested' on creation and 'deleting' on deletion. Once the Fabric VC has found its corresponding Fabric…
VlanVirtualCircuit_status
string
The status of a Virtual Circuit is always 'pending' on creation. The status can turn to 'Waiting on Customer VLAN' if a Metro VLAN was not set yet on the Virtu…
InterconnectionPort
object
10 properties
Interconnection_redundancy
string
Either 'primary', meaning a single interconnection, or 'redundant', meaning a redundant interconnection.
DedicatedPortCreateInput_mode
string
The mode of the interconnection (only relevant to Dedicated Ports). Fabric VCs won't have this field. Can be either 'standard' or 'tunnel'. The default mode of…
DedicatedPortCreateInput_type
string
When requesting for a dedicated port, the value of this field should be 'dedicated'.
InterconnectionPortList
object
1 property
Organization
object
17 properties
VrfFabricVcCreateInput
object
11 properties 6 required
createOrganizationInterconnection_request
Interconnection
object
19 properties
InterconnectionList
object
2 properties
Project_type
string
The type of the project. Projects of type vmce are part of an in development feature and not available to all customers.
Vrf
object
17 properties
VlanFabricVcCreateInput
object
11 properties 5 required
VirtualCircuitCreateInput
VirtualCircuitList
object
1 property
VrfIpReservation_type
string
FabricServiceToken_role
string
Either primary or secondary, depending on which interconnection the service token is associated to.
FabricServiceToken
object
6 properties
VrfVirtualCircuitUpdateInput
object
9 properties
VlanVirtualCircuitUpdateInput
object
5 properties
Project
object
19 properties
FabricServiceToken_state
string
The state of the service token that corresponds with the service token state on Fabric. An 'inactive' state refers to a token that has not been redeemed yet on…
Coordinates
object
2 properties
InterconnectionUpdateInput
object
6 properties
VlanFabricVcCreateInput_type
string
When requesting for a Fabric VC, the value of this field should be 'shared'.
VirtualCircuit
User
object
22 properties
Metro
object
4 properties
Error
object
Error responses are included with 4xx and 5xx HTTP responses from the API service. Either "error" or "errors" will be set.
2 properties
VlanVirtualCircuit_type
string
Interconnection_type
string
The 'shared' type of interconnection refers to shared connections, or later also known as Fabric Virtual Connections (or Fabric VCs). The 'dedicated' type of i…
FabricServiceToken_service_token_type
string
Either 'aside' or 'zside', depending on which type of Fabric VC was requested.
VlanVirtualCircuitCreateInput
object
7 properties 1 required
VrfVirtualCircuitCreateInput
object
12 properties 5 required
Href
object
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

equinix-interconnections-api-openapi.yml Raw ↑

Other APIs Equinix publishes across the network.

Equinix Agent Templates API
Equinix Agents API
Equinix Authentication API
Equinix availability API
Equinix Batches API
Equinix BGP API
Equinix Capacity API
Equinix Cloud Events API
Equinix Cloud Routers API
Equinix Company Profiles API
Equinix Connections API
Equinix Console Log Details API