# IPs

## Cloudflare/JD Cloud IP Details

`client.ips.list(IPListParamsquery?, RequestOptionsoptions?): IPListResponse`

**get** `/ips`

Get IPs used on the Cloudflare/JD Cloud network, see https://www.cloudflare.com/ips for Cloudflare IPs or https://developers.cloudflare.com/china-network/reference/infrastructure/ for JD Cloud IPs.

### Parameters

- `query: IPListParams`

  - `networks?: string`

    Specified as `jdcloud` to list IPs used by JD Cloud data centers.

### Returns

- `IPListResponse = PublicIPIPs | PublicIPIPsJDCloud`

  - `PublicIPIPs`

    - `etag?: string`

      A digest of the IP data. Useful for determining if the data has changed.

    - `ipv4_cidrs?: Array<string>`

      List of Cloudflare IPv4 CIDR addresses.

    - `ipv6_cidrs?: Array<string>`

      List of Cloudflare IPv6 CIDR addresses.

  - `PublicIPIPsJDCloud`

    - `etag?: string`

      A digest of the IP data. Useful for determining if the data has changed.

    - `ipv4_cidrs?: Array<string>`

      List of Cloudflare IPv4 CIDR addresses.

    - `ipv6_cidrs?: Array<string>`

      List of Cloudflare IPv6 CIDR addresses.

    - `jdcloud_cidrs?: Array<string>`

      List IPv4 and IPv6 CIDRs, only populated if `?networks=jdcloud` is used.

### Example

```node
import Cloudflare from 'cloudflare';

const client = new Cloudflare();

const ips = await client.ips.list();

console.log(ips);
```

#### Response

```json
{
  "errors": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "messages": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "success": true,
  "result": {
    "etag": "a8e453d9d129a3769407127936edfdb0",
    "ipv4_cidrs": [
      "199.27.128.0/21"
    ],
    "ipv6_cidrs": [
      "2400:cb00::/32"
    ]
  }
}
```

## Domain Types

### IPs

- `IPsArray = Array<IPsArrayItem>`

  The set of IPs on the Address Map.

  - `created_at?: string`

  - `ip?: string`

    An IPv4 or IPv6 address.

### IP List Response

- `IPListResponse = PublicIPIPs | PublicIPIPsJDCloud`

  - `PublicIPIPs`

    - `etag?: string`

      A digest of the IP data. Useful for determining if the data has changed.

    - `ipv4_cidrs?: Array<string>`

      List of Cloudflare IPv4 CIDR addresses.

    - `ipv6_cidrs?: Array<string>`

      List of Cloudflare IPv6 CIDR addresses.

  - `PublicIPIPsJDCloud`

    - `etag?: string`

      A digest of the IP data. Useful for determining if the data has changed.

    - `ipv4_cidrs?: Array<string>`

      List of Cloudflare IPv4 CIDR addresses.

    - `ipv6_cidrs?: Array<string>`

      List of Cloudflare IPv6 CIDR addresses.

    - `jdcloud_cidrs?: Array<string>`

      List IPv4 and IPv6 CIDRs, only populated if `?networks=jdcloud` is used.