---
title: "Lists information about known IP addresses"
method: GET
path: "/ip"
tags: ["policy"]
---

# Lists information about known IP addresses

`GET /ip`

Retrieves a list of IPs with known associated information such as
their identities, host addresses, Kubernetes pod names, etc.
The list can optionally filtered by a CIDR IP range.

## Query parameters

- `cidr` string

## Request body

- string[] — Set of labels

## Response `200`

Success

- IPListEntry[]
  - `cidr` string, required — Key of the entry in the form of a CIDR range
  - `identity` integer, required — Numerical identity assigned to the IP
  - `hostIP` string — IP address of the host
  - `encryptKey` integer — The context ID for the encryption session
  - `metadata` IPListEntryMetadata — Additional metadata assigned to an IP list entry
    - `source` string — Source of the IP entry and its metadata
    - `namespace` string — Namespace of the IP (e.g. Kubernetes namespace)
    - `name` string — Name assigned to the IP (e.g. Kubernetes pod name)

## Other responses

- `400` — Invalid request (error parsing parameters)
- `404` — No IP cache entries with provided parameters found

---

[API](https://skmtc.net/cilium/apis/cilium-api.md) · [All operations](https://skmtc.net/cilium/apis/cilium-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cilium/cilium-api/revisions/351336b27221/schema)