Equinix Fabric API v4 | Equinix Product Documentation

Retrieve IP Block by ID

Request

Retrieve IP Block by UUID

Security

BearerAuth

Path

uuidstring, (uuid)required

UUID of the IP Block

Payload

// No request payload

Responses

IP Block retrieved successfully

Bodyapplication/json

uuidstring, (uuid)required

Unique identifier for the IP Block

hrefstringrequired

Resource URL path for the IP Block

Example:"/fabric/v4/ipBlocks/31fbdb3f-8def-410d-868b-ef920878affb"

typestring(TypeOfIpBlockProduct)required

Enum:"IPV4_IP_BLOCK""IPV6_IP_BLOCK"

statestring(IpBlockState)required

Current state of the IP Block

Enum:"PENDING""ACTIVE""DELETING""DELETED""FAILED"

ownershipstring(IpBlockOwnership)required

IpBlockOwnership of the IP Block

Enum:"EQUINIX""CUSTOMER"

locationobject(IpBlockLocation)

prefixLengthinteger, [ 1 .. 128 ](IpBlockPrefixLength)required

IpBlockPrefix length

prefixstring(IpBlockPrefix)

CIDR prefix

orderobject(IpBlockOrderResponse)

accountobject(IpBlockAccount)

projectobject(IpBlockProject)required

regulationsobject(IpBlockRegulations)

assetsArray of objects(IpBlockAsset)

Products using this IP Block

changeobject(IpBlockChange)

changeLogobject(IpBlockChangeLog)required

errorobject(Error)

Error Response with details

Response

{
  "href": "https://api.equinix.com/fabric/v4/ipBlocks/31fbdb3f-8def-410d-868b-ef920878affb",
  "uuid": "31fbdb3f-8def-410d-868b-ef920878affb",
  "state": "PENDING",
  "ownership": "EQUINIX",
  "location": {
    "metroHref": "https://api.equinix.com/fabric/v4/metros/WA",
    "metroCode": "SY"
  },
  "prefixLength": 24,
  "type": "IPV4_IP_BLOCK",
  "change": {
    "href": "https://api.equinix.com/fabric/v4/ipBlocks/31fbdb3f-8def-410d-868b-ef920878affb/cloudEvents"
  },
  "order": {
    "href": "https://api.equinix.com/colocations/v2/orders/1-34834234",
    "orderNumber": "1-34834234"
  },
  "account": {
    "href": "https://api.equinix.com/billing/v2/billingAccounts/accountNumber/2-57689234",
    "accountNumber": "2-57689234"
  },
  "project": {
    "href": "https://api.equinix.com/resourceManager/v2/projects/03ed2230-604a-494c-bca2-c042d38d80bc",
    "projectId": "03ed2230-604a-494c-bca2-c042d38d80bc"
  },
  "regulations": {
    "addressingPlans": [ … ],
    "questions": { … }
  },
  "changeLog": {
    "createdDateTime": "2025-12-01T12:11:22.222351Z"
  },
  "assets": []
}