## List existing CNI objects

`client.networkInterconnects.cnis.list(CNIListParamsparams, RequestOptionsoptions?): CNIListResponse`

**get** `/accounts/{account_id}/cni/cnis`

List existing CNI objects

### Parameters

- `params: CNIListParams`

  - `account_id: string`

    Path param: Customer account tag

  - `cursor?: number | null`

    Query param

  - `limit?: number | null`

    Query param

  - `slot?: string | null`

    Query param: If specified, only show CNIs associated with the specified slot

  - `tunnel_id?: string | null`

    Query param: If specified, only show cnis associated with the specified tunnel id

### Returns

- `CNIListResponse`

  - `items: Array<Item>`

    - `id: string`

    - `account: string`

      Customer account tag

    - `cust_ip: string`

      Customer end of the point-to-point link

      This should always be inside the same prefix as `p2p_ip`.

    - `interconnect: string`

      Interconnect identifier hosting this CNI

    - `magic: Magic`

      - `conduit_name: string`

      - `description: string`

      - `mtu: number`

    - `p2p_ip: string`

      Cloudflare end of the point-to-point link

    - `bgp?: BGP`

      - `customer_asn: number`

        ASN used on the customer end of the BGP session

      - `extra_prefixes: Array<string>`

        Extra set of static prefixes to advertise to the customer's end of the session

      - `md5_key?: string | null`

        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.

  - `next?: number | null`

### Example

```node
import Cloudflare from 'cloudflare';

const client = new Cloudflare({
  apiToken: process.env['CLOUDFLARE_API_TOKEN'], // This is the default and can be omitted
});

const cnis = await client.networkInterconnects.cnis.list({ account_id: 'account_id' });

console.log(cnis.items);
```

#### Response

```json
{
  "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": [
          "string"
        ],
        "md5_key": "md5_key"
      }
    }
  ],
  "next": 0
}
```