# IPs

## Cloudflare/JD Cloud IP Details

`ips.list(IPListParams**kwargs)  -> 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

- `networks: Optional[str]`

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

### Returns

- `IPListResponse`

  - `class PublicIPIPs: …`

    - `etag: Optional[str]`

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

    - `ipv4_cidrs: Optional[List[str]]`

      List of Cloudflare IPv4 CIDR addresses.

    - `ipv6_cidrs: Optional[List[str]]`

      List of Cloudflare IPv6 CIDR addresses.

  - `class PublicIPIPsJDCloud: …`

    - `etag: Optional[str]`

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

    - `ipv4_cidrs: Optional[List[str]]`

      List of Cloudflare IPv4 CIDR addresses.

    - `ipv6_cidrs: Optional[List[str]]`

      List of Cloudflare IPv6 CIDR addresses.

    - `jdcloud_cidrs: Optional[List[str]]`

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

### Example

```python
from cloudflare import Cloudflare

client = Cloudflare()
ips = client.ips.list()
print(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

- `List[IPItem]`

  The set of IPs on the Address Map.

  - `created_at: Optional[datetime]`

  - `ip: Optional[str]`

    An IPv4 or IPv6 address.

### IP List Response

- `IPListResponse`

  - `class PublicIPIPs: …`

    - `etag: Optional[str]`

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

    - `ipv4_cidrs: Optional[List[str]]`

      List of Cloudflare IPv4 CIDR addresses.

    - `ipv6_cidrs: Optional[List[str]]`

      List of Cloudflare IPv6 CIDR addresses.

  - `class PublicIPIPsJDCloud: …`

    - `etag: Optional[str]`

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

    - `ipv4_cidrs: Optional[List[str]]`

      List of Cloudflare IPv4 CIDR addresses.

    - `ipv6_cidrs: Optional[List[str]]`

      List of Cloudflare IPv6 CIDR addresses.

    - `jdcloud_cidrs: Optional[List[str]]`

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