--- title: List existing interconnects --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api) [Network Interconnects](https://developers.cloudflare.com/api/resources/network_interconnects) [Interconnects](https://developers.cloudflare.com/api/resources/network_interconnects/subresources/interconnects) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # List existing interconnects GET/accounts/{account\_id}/cni/interconnects Lists all network interconnects configured for the account, including physical and virtual connections. ##### Security

API Token

The preferred authorization scheme for interacting with the Cloudflare API. Create a token. **Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY

API Email + API Key

The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key. **Example:**X-Auth-Email: user@example.com The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys. **Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194

##### Accepted Permissions (at least one required) `Magic WAN Write``Magic WAN Read``Magic Transit Read``Magic Transit Write` ##### P ath ParametersExpand Collapse account\_id: string Customer account tag [Link to this property](<#(resource)%20network_interconnects.interconnects%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>) ##### Q uery ParametersExpand Collapse cursor: optional number formatint32 [Link to this property](<#(resource)%20network_interconnects.interconnects%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20cursor%20%3E%20(schema)>) limit: optional number minimum0 [Link to this property](<#(resource)%20network_interconnects.interconnects%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20limit%20%3E%20(schema)>) site: optional string If specified, only show interconnects located at the given site [Link to this property](<#(resource)%20network_interconnects.interconnects%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20site%20%3E%20(schema)>) type: optional string If specified, only show interconnects of the given type [Link to this property](<#(resource)%20network_interconnects.interconnects%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20type%20%3E%20(schema)>) ##### ReturnsExpand Collapse

items: array of object {account, facility, name, 7 more } or object {account, name, region, 4 more }

One of the following:

NscInterconnectPhysicalBody object {account, facility, name, 7 more }

account: string Link to this property

facility: object {address, name }

address: array of string Link to this property name: string Link to this property

Link to this property name: string Link to this property site: string A Cloudflare site name. Link to this property slot\_id: string formatuuid Link to this property speed: string Link to this property type: string Link to this property virtual\_port\_reservation\_id: string formatuuid Link to this property ccr\_device\_name: optional string Link to this property owner: optional string Link to this property

Link to this property

NscInterconnectGcpPartnerBody object {account, name, region, 4 more }

account: string Link to this property name: string Link to this property region: string Link to this property type: string Link to this property virtual\_port\_reservation\_id: string formatuuid Link to this property owner: optional string Link to this property

speed: optional "50M"or "100M"or "200M"or 9 more Bandwidth structure as visible through the customer-facing API.

One of the following: "50M" Link to this property "100M" Link to this property "200M" Link to this property "300M" Link to this property "400M" Link to this property "500M" Link to this property "1G" Link to this property "2G" Link to this property "5G" Link to this property "10G" Link to this property "20G" Link to this property "50G" Link to this property

Link to this property

[Link to this property](<#(resource)%20network_interconnects.interconnects%20%3E%20(model)%20interconnect_list_response%20%3E%20(schema)%20%3E%20(property)%20items>) next: optional number formatint32 [Link to this property](<#(resource)%20network_interconnects.interconnects%20%3E%20(model)%20interconnect_list_response%20%3E%20(schema)%20%3E%20(property)%20next>) ### List existing interconnects HTTP HTTPTypeScriptPythonGoTerraform ``` curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/cni/interconnects \ -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" ``` 200 example ``` { "items": [ { "account": "account", "facility": { "address": [ "string" ], "name": "name" }, "name": "name", "site": "site", "slot_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", "speed": "speed", "type": "type", "virtual_port_reservation_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", "ccr_device_name": "ccr_device_name", "owner": "owner" } ], "next": 0 } ``` ##### Returns Examples 200 example ``` { "items": [ { "account": "account", "facility": { "address": [ "string" ], "name": "name" }, "name": "name", "site": "site", "slot_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", "speed": "speed", "type": "type", "virtual_port_reservation_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", "ccr_device_name": "ccr_device_name", "owner": "owner" } ], "next": 0 } ```