Equinix Fabric API v4 | Equinix Product Documentation

Get Cross Connect

Request

The API provides capability to get Cross Connect details by Cross Connect ID.

Security

BearerAuth

Path

crossConnectIdstring, (uuid)required

Cross Connect UUID.

Example:46bb1a31-c28f-4197-8b10-06e0e03d0743

Payload

// No request payload

Responses

Successful operation.

Bodyapplication/json

hrefstring, (uri)

Cross Connect URI.

Example:"https://api.equinix.com/fabric/v4/crossConnects/46bb1a31-c28f-4197-8b10-06e0e03d0743"

typestring(CrossConnectType)

Type of Cross Connect.

Value:"XC"

Example:"XC"

uuidstring, (uuid)

Cross Connect Identifier.

Example:"46bb1a31-c28f-4197-8b10-06e0e03d0743"

namestring

A short, descriptive name for this Cross Connect.

Example:"My-CC-service"

statestring(CrossConnectState)

Cross Connect State.

Enum:"PENDING""PENDING_ACTION""PROVISIONING""PROVISIONED""DEPROVISIONING""DEPROVISIONED""CANCELLING""CANCELLED""FAILED"

Example:"PENDING"

allowedActionsArray of objectsread-only

List of actions that can be performed on the Cross Connect based on its current state. Use these values to determine which action types are valid to submit to the actions endpoint.

bmmrTypestring(BmmrType)

Cross Connect BMMR Type.

Enum:"EQUINIX""SELF"

Example:"EQUINIX"

mediaTypestring

Media type of the Cross Connect.

Example:"SINGLE_MODE_FIBER"

mediaSubTypestring

Media sub-type of the Cross Connect.

Example:"SINGLE_MODE_FIBER"

circuitIdstring

Circuit identifier of the Cross Connect.

serialNumberstringread-only

Serial number of the Cross Connect.

Example:"234567890"

redundancyobject(CrossConnectRedundancy)

Cross Connect Redundancy.

aSideobject(CrossConnectASideResponse)

A-Side connection details.

zSideobject(CrossConnectZSideResponse)

Z-Side connection details.

accountobject(CrossConnectAccount)

Account the Cross Connect belongs to.

notificationsArray of objects(CrossConnectNotification)

Preferences for notifications on Cross Connect configuration or status changes.

orderobject(OrderResponse)

Cross Connect Order.

linksArray of objects(CrossConnectLink)read-only

Links to the Cross Connect sub-resources - schedules, services, notes and attachments.

changeLogobject(CrossConnectChangelog)

Cross Connect Change Log.

Response

{
  "href": "https://api.equinix.com/fabric/v4/crossConnects/46bb1a31-c28f-4197-8b10-06e0e03d0743",
  "type": "XC",
  "name": "My-CC-service",
  "uuid": "46bb1a31-c28f-4197-8b10-06e0e03d0743",
  "state": "PROVISIONING",
  "serialNumber": "234567890",
  "redundancy": {
    "group": "7cf39156-9dec-40f7-a254-9bb401342e83",
    "priority": "PRIMARY"
  },
  "aSide": {
    "demarcationPoint": { … },
    "location": { … }
  },
  "zSide": {
    "demarcationPoint": { … },
    "location": { … }
  },
  "account": {
    "accountNumber": 123456
  },
  "notifications": [
    { … },
    { … },
    { … }
  ],
  "order": {
    "orderNumber": "1-1234567890",
    "customerReferenceId": "12345"
  },
  "links": [
    { … },
    { … },
    { … },
    { … }
  ],
  "changeLog": {
    "createdDateTime": "2026-02-28T07:21:39Z",
    "createdBy": "testuser"
  }
}