---
title: List existing CNI objects
---
[Skip to content](#_top)
[API Reference](https://developers.cloudflare.com/api)
[Network Interconnects](https://developers.cloudflare.com/api/resources/network_interconnects)
[CNIs](https://developers.cloudflare.com/api/resources/network_interconnects/subresources/cnis)
Copy Markdown
Open in **Claude**Open in **ChatGPT**Open in **Cursor**
---
**Copy Markdown****View as Markdown**
# List existing CNI objects
GET/accounts/{account\_id}/cni/cnis
Lists all Cloud Network Interconnects (CNIs) configured for the account, showing connection status and parameters.
##### 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.cnis%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.cnis%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.cnis%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20limit%20%3E%20(schema)>)
slot: optional string
If specified, only show CNIs associated with the specified slot
[Link to this property](<#(resource)%20network_interconnects.cnis%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20slot%20%3E%20(schema)>)
tunnel\_id: optional string
If specified, only show cnis associated with the specified tunnel id
[Link to this property](<#(resource)%20network_interconnects.cnis%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20tunnel_id%20%3E%20(schema)>)
##### ReturnsExpand Collapse
items: array of object {id, account, cust\_ip, 5 more }
id: string
formatuuid
Link to this property
account: string
Customer account tag
Link to this property
cust\_ip: string
Customer end of the point-to-point link
This should always be inside the same prefix as p2p_ip.
formatA.B.C.D/N
Link to this property
interconnect: string
Interconnect identifier hosting this CNI
Link to this property
magic: object {conduit\_name, description, mtu }
conduit\_name: string
Link to this property
description: string
Link to this property
mtu: number
formatint32
minimum0
Link to this property
Link to this property
p2p\_ip: string
Cloudflare end of the point-to-point link
formatA.B.C.D/N
Link to this property
bgp: optional object {customer\_asn, extra\_prefixes, md5\_key }
customer\_asn: number
ASN used on the customer end of the BGP session
formatint32
minimum0
Link to this property
extra\_prefixes: array of string
Extra set of static prefixes to advertise to the customer’s end of the session
Link to this property
md5\_key: optional string
MD5 key to use for session authentication.
Note that *this is not a security measure*. MD5 is not a valid security mechanism, and the key is not treated as a secret value. This is *only* supported for preventing misconfiguration, not for defending against malicious attacks.
The MD5 key, if set, must be of non-zero length and consist only of the following types of character:
- ASCII alphanumerics: [a-zA-Z0-9]
- Special characters in the set '!@#$%^&*()+[]{}<>/.,;:_-~= |\`
In other words, MD5 keys may contain any printable ASCII character aside from newline (0x0A), quotation mark ("), vertical tab (0x0B), carriage return (0x0D), tab (0x09), form feed (0x0C), and the question mark (?). Requests specifying an MD5 key with one or more of these disallowed characters will be rejected.
Link to this property
Link to this property
bgp\_mode: optional "dynamic\_route\_exchange"or "advertise\_only"
The BGP mode for a CNI. One of the following:
- dynamic_route_exchange
- advertise_only
One of the following:
"dynamic\_route\_exchange"
Link to this property
"advertise\_only"
Link to this property
Link to this property
[Link to this property](<#(resource)%20network_interconnects.cnis%20%3E%20(model)%20cni_list_response%20%3E%20(schema)%20%3E%20(property)%20items>)
next: optional number
formatint32
[Link to this property](<#(resource)%20network_interconnects.cnis%20%3E%20(model)%20cni_list_response%20%3E%20(schema)%20%3E%20(property)%20next>)
### List existing CNI objects
HTTP
HTTPTypeScriptPythonGoTerraform
```
curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/cni/cnis \
-H "Authorization: Bearer $CLOUDFLARE_API_TOKEN"
```
200 example
```
{
"items": [
{
"id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
"account": "account",
"cust_ip": "192.168.3.4/31",
"interconnect": "interconnect",
"magic": {
"conduit_name": "conduit_name",
"description": "description",
"mtu": 0
},
"p2p_ip": "192.168.3.4/31",
"bgp": {
"customer_asn": 0,
"extra_prefixes": [
"192.168.3.4/31"
],
"md5_key": "md5_key"
},
"bgp_mode": "dynamic_route_exchange"
}
],
"next": 0
}
```
##### Returns Examples
200 example
```
{
"items": [
{
"id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
"account": "account",
"cust_ip": "192.168.3.4/31",
"interconnect": "interconnect",
"magic": {
"conduit_name": "conduit_name",
"description": "description",
"mtu": 0
},
"p2p_ip": "192.168.3.4/31",
"bgp": {
"customer_asn": 0,
"extra_prefixes": [
"192.168.3.4/31"
],
"md5_key": "md5_key"
},
"bgp_mode": "dynamic_route_exchange"
}
],
"next": 0
}
```