---
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

---

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