---
title: "Returns a list of ZoneIngress in the mesh."
method: GET
path: "/v1/mesh/control-planes/{cpId}/api/zoneingresses"
tags: ["ZoneIngress"]
---

# Returns a list of ZoneIngress in the mesh.

`GET /v1/mesh/control-planes/{cpId}/api/zoneingresses`

## Query parameters

- `offset` integer
- `size` integer
- `filter` object
  - `key` string
  - `value` string

## Response `200`

List

- object
  - `items` ZoneIngressItem[], nullable
    - `availableServices` object[], nullable — AvailableService contains tags that represent unique subset of endpoints
      - `externalService` boolean — instance of external service available from the zone
      - `instances` integer — number of instances available for given tags
      - `mesh` string — mesh of the instances available for given tags
      - `tags` object — tags of the service
    - `creationTime` string, date-time — Time at which the resource was created
    - `kri` string — Kuma Resource Identifier (KRI) of the given resource
    - `labels` object
    - `modificationTime` string, date-time — Time at which the resource was updated
    - `name` string, required
    - `networking` object — Networking defines the address and port of the Ingress to listen on. Additionally publicly advertised address and port could be specified.
      - `address` string — Address on which inbound listener will be exposed
      - `admin` object — Admin contains configuration related to Envoy Admin API
        - `port` integer — Port on which Envoy Admin API server will be listening
      - `advertisedAddress` string — AdvertisedAddress defines IP or DNS name on which ZoneIngress is accessible to other Kuma clusters.
      - `advertisedPort` integer — AdvertisedPort defines port on which ZoneIngress is accessible to other Kuma clusters.
      - `port` integer — Port of the inbound interface that will forward requests to the service.
    - `type` string, required
    - `zone` string — Zone field contains Zone name where ingress is serving, field will be automatically set by Global Kuma CP
  - `next` string, nullable — URL to the next page
  - `total` number, nullable — The total number of entities

## Changes

- **2026-08-18** `658ffb748f95` — 3 info
  - added the optional property `items/items/creationTime` to the response with the `200` status
  - added the optional property `items/items/kri` to the response with the `200` status
  - added the optional property `items/items/modificationTime` to the response with the `200` status
- **2025-11-06** `5d2b35832e3f` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/kong/apis/konnect-api-beta/changes/v1/mesh/control-planes/:cpId/api/zoneingresses/get.md)

---

[API](https://skmtc.dev/kong/apis/konnect-api-beta.md) · [All operations](https://skmtc.dev/kong/apis/konnect-api-beta/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/kong/konnect-api-beta/revisions/cef0f947e9c9/schema)