Equinix Fabric API v4 | Equinix Product Documentation

Get Port by ID

Request

Get Port by ID returns details of assigned and available Equinix Fabric port for the specified user credentials. The metro code attribute in the response shows the origin of the proposed connection

Security

BearerAuth

Path

portIdstring, (uuid)required

Port UUID

Payload

// No request payload

Responses

Successful operation

Bodyapplication/json

hrefstring, (uri)read-only

Equinix assigned response attribute for an absolute URL that is the subject of the link's context.

typestring(PortType)

Type of Port

Value:"XF_PORT"

uuidstring, (uuid)

Equinix assigned response attribute for port identifier

namestring

Equinix assigned response attribute for Port name

descriptionstring

Equinix assigned response attribute for Port description

physicalPortsSpeedinteger, >= 0

Physical Ports Speed in Mbps

connectionsCountinteger, >= 0

Equinix assigned response attribute for Connection count

physicalPortsTypestring

Physical Ports Type. 10GBASE_SMF and 400GBASE_LR4 are only used for IX ports

Enum:"1000BASE_LX""10GBASE_LR""100GBASE_LR4""10GBASE_ER""1000BASE_SX""10GBASE_SMF""400GBASE_LR4"

physicalPortsCountinteger

connectivitySourceTypestring

Port connectivity type

Enum:"COLO""BMMR""REMOTE"

bmmrTypestring

Enum:"SELF""EQUINIX"

projectobject(Project)

statestring(PortState)

Port lifecycle state

Enum:"PENDING""PROVISIONING""REPROVISIONING""PENDING_CROSS_CONNECT""PROVISIONED""ACTIVE""DEPROVISIONING""DEPROVISIONED""INACTIVE""FAILED"

orderobject(PortOrder)

operationobject(PortOperation)

Operational specifications for ports.

accountobject(SimplifiedAccount)

changeobject(PortChange)

Current state of latest port change

changeLogobject(Changelog)

Change log

serviceCodestring(PortServiceCode)

Identifies the service type associated with this port

Enum:"CX""IX""IA""MC"

availableBandwidthinteger, >= 0

Equinix assigned response attribute for Port available bandwidth in Mbps

usedBandwidthinteger, >= 0

Equinix assigned response attribute for Port used bandwidth in Mbps

locationobject(SimplifiedLocation)

deviceobject(PortDevice)

Port device

interfaceobject(PortInterface)

Port interface

demarcationPointIbxstring

A-side/Equinix ibx

tetherIbxstring

z-side/Equinix ibx

demarcationPointobject(PortDemarcationPoint)

Customer physical Port

redundancyobject(PortRedundancy)

Port redundancy configuration

encapsulationobject(PortEncapsulation)

Port encapsulation configuration

lagEnabledboolean

If LAG enabled

asninteger

Port ASN

packageobject(Package)

Package settings for port

settingsobject(PortSettings)

Port configuration settings

physicalPortQuantityinteger

Number of physical ports

notificationsArray of objects(PortNotification)

Notification preferences

additionalInfoArray of objects(PortAdditionalInfo)

Port additional information

physicalPortsArray of objects(PhysicalPort)

Physical ports that implement this port

loasArray of objects(PortLoa)

Port Loas

marketplaceSubscriptionobject(marketplaceSubscription)

Equinix Fabric Entity for Marketplace Subscription

serviceTypestringdeprecated

Port service Type

Enum:"EPL""MSP"

bandwidthinteger, >= 0deprecated

Equinix assigned response attribute for Port bandwidth in Mbps

lagobject(PortLag)deprecated

Port Lag

Response

{
  "href": "https://api.equinix.com/fabric/v4/ports/44c5712b-d704-4ca5-9b42-ee6be32ee06a",
  "type": "XF_PORT",
  "uuid": "44c5712b-d704-4ca5-9b42-ee6be32ee06a",
  "name": "270843-DA1-CX-PRI-33",
  "physicalPortsSpeed": 1000,
  "physicalPortsType": "1000BASE_LX",
  "project": {
    "projectId": "66a2d2f7-b79b-49bc-8642-d2b3c1c138b4"
  },
  "package": {
    "code": "UNLIMITED"
  },
  "state": "ACTIVE",
  "cvpId": "2000833",
  "connectivitySourceType": "COLO",
  "operation": {
    "operationalStatus": "UP",
    "connectionCount": 10,
    "evplVCCount": 10,
    "accessVCCount": 0
  },
  "account": {
    "accountNumber": 270843,
    "accountName": "ctr-sit-account1",
    "orgId": 93055,
    "organizationName": "ctr-sit-account1-270843",
    "ucmId": "64726950-A62C-4749-98E2-5AA4CA44284F",
    "globalCustId": "0016u000003JZ3XAAW"
  },
  "change": {
    "uuid": "ed41e367-e09d-4c2f-b6ab-30506de4437f",
    "type": "PORT_UPDATE",
    "status": "COMPLETED",
    "data": { … },
    "createdDateTime": "2025-05-29T20:38:45.630759Z",
    "updatedDateTime": "2025-05-29T20:38:49.330822Z"
  },
  "changeLog": {
    "createdBy": "qa-automation",
    "createdDateTime": "2025-05-21T18:12:18.300Z",
    "updatedBy": "qa-automation",
    "updatedDateTime": "2025-05-29T20:38:48.900Z"
  },
  "bandwidth": 1000,
  "availableBandwidth": 500,
  "usedBandwidth": 500,
  "location": {
    "metroHref": "https://api.equinix.com/fabric/v4/metros/DA",
    "region": "AMER",
    "metroName": "Dallas",
    "metroCode": "DA",
    "ibx": "DA1"
  },
  "device": {
    "name": "qa3-da-a1.lab",
    "redundancy": { … }
  },
  "demarcationPointIbx": "DA1",
  "tetherIbx": "DA1",
  "redundancy": {
    "priority": "PRIMARY"
  },
  "encapsulation": {
    "type": "QINQ",
    "tagProtocolId": "0x88a8"
  },
  "lagEnabled": false,
  "settings": {
    "buyout": true,
    "viewPortPermission": true,
    "placeVcOrderPermission": true
  },
  "physicalPorts": [
    { … }
  ]
}