--- title: Get the current status of an interconnect object --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/typescript) [Network Interconnects](https://developers.cloudflare.com/api/typescript/resources/network_interconnects) [Interconnects](https://developers.cloudflare.com/api/typescript/resources/network_interconnects/subresources/interconnects) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Get the current status of an interconnect object client.networkInterconnects.interconnects.status(stringicon, InterconnectStatusParams {account\_id } params, RequestOptionsoptions?): [InterconnectStatusResponse]() GET/accounts/{account\_id}/cni/interconnects/{icon}/status Gets the current operational status of a network interconnect, including link state and traffic metrics. ##### 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` ##### ParametersExpand Collapse icon: string [Link to this property](<#(resource)%20network_interconnects.interconnects%20%3E%20(method)%20status%20%3E%20(params)%20default%20%3E%20(param)%20icon%20%3E%20(schema)>)

params: InterconnectStatusParams {account\_id }

account\_id: string Customer account tag Link to this property

[Link to this property](<#(resource)%20network_interconnects.interconnects%20%3E%20(method)%20status%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse

InterconnectStatusResponse = Pending {state } | Down {state, reason } | Unhealthy {state, reason } | Healthy {state }

One of the following:

Pending {state }

state: "Pending" Link to this property

Link to this property

Down {state, reason }

state: "Down" Link to this property reason?: string| null Diagnostic information, if available Link to this property

Link to this property

Unhealthy {state, reason }

state: "Unhealthy" Link to this property reason?: string| null Diagnostic information, if available Link to this property

Link to this property

Healthy {state }

state: "Healthy" Link to this property

Link to this property

[Link to this property](<#(resource)%20network_interconnects.interconnects%20%3E%20(model)%20interconnect_status_response%20%3E%20(schema)>) ### Get the current status of an interconnect object TypeScript HTTPTypeScriptPythonGoTerraform ``` import Cloudflare from 'cloudflare'; const client = new Cloudflare({ apiToken: process.env['CLOUDFLARE_API_TOKEN'], // This is the default and can be omitted }); const response = await client.networkInterconnects.interconnects.status('icon', { account_id: 'account_id', }); console.log(response); ``` 200 example ``` { "state": "Pending" } ``` ##### Returns Examples 200 example ``` { "state": "Pending" } ```