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

# Returns a list of MeshMultiZoneService in the mesh.

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

## Request

- Base URL: `https://global.api.konghq.com`
- URL: `https://global.api.konghq.com/v1/mesh/control-planes/{cpId}/api/meshes/{mesh}/meshmultizoneservices`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer
  - HTTP bearer
  - HTTP bearer

## Path parameters

- `mesh` string, required

## Query parameters

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

## Response `200`

List

- object
  - `items` MeshMultiZoneServiceItem[]
    - `type` 'MeshMultiZoneService', required: the type of the resource
    - `mesh` string: Mesh is the name of the Kuma mesh this resource belongs to. It may be omitted for cluster-scoped resources.
    - `kri` string: A unique identifier for this resource instance used by internal tooling and integrations. Typically derived from resource attributes and may be used for cross-references or indexing
    - `snis` object[]: List of SNIs (Server Name Indication) advertised by xDS for this destination, one entry per port, sorted by port ascending. Present for MeshService, MeshMultiZoneService and MeshExternalService.
      - `port` integer, required: The destination port this SNI corresponds to.
      - `sni` string, required: The SNI string advertised by xDS for this port.
    - `name` string, required: Name of the Kuma resource
    - `labels` object: The labels to help identity resources
    - `spec` object, required: Spec is the specification of the Kuma MeshMultiZoneService resource.
      - `ports` object[], required: Ports is a list of ports from selected MeshServices
        - `appProtocol` string: Protocol identifies a protocol supported by a service.
        - `name` string
        - `port` integer, required
      - `selector` object, required: Selector is a way to select multiple MeshServices
        - `meshService` object, required: MeshService selects MeshServices
          - `matchLabels` object
    - `creationTime` string, date-time: Time at which the resource was created
    - `modificationTime` string, date-time: Time at which the resource was updated
    - `status` object: Status is the current status of the Kuma MeshMultiZoneService resource.
      - `addresses` object[]: Addresses is a list of addresses generated by HostnameGenerator
        - `hostname` string
        - `hostnameGeneratorRef` object
          - `coreName` string, required
        - `origin` string
      - `conditions` object[]: Conditions is an array of current conditions
        - `message` string, required: message is a human readable message indicating details about the transition. This may be an empty string.
        - `reason` string, required: reason contains a programmatic identifier indicating the reason for the condition's last transition. Producers of specific condition types may define expected values and meanings for this field, and whether the values are considered a guaranteed API. The value should be a CamelCase string. This field may not be empty.
        - `status` 'True' | 'False' | 'Unknown', required: status of the condition, one of True, False, Unknown.
        - `type` string, required: type of condition in CamelCase or in foo.example.com/CamelCase.
      - `hostnameGenerators` object[]: Status of hostnames generator applied on this resource
        - `conditions` object[]: Conditions is an array of hostname generator conditions.
          - `message` string, required: message is a human readable message indicating details about the transition. This may be an empty string.
          - `reason` string, required: reason contains a programmatic identifier indicating the reason for the condition's last transition. Producers of specific condition types may define expected values and meanings for this field, and whether the values are considered a guaranteed API. The value should be a CamelCase string. This field may not be empty.
          - `status` 'True' | 'False' | 'Unknown', required: status of the condition, one of True, False, Unknown.
          - `type` string, required: type of condition in CamelCase or in foo.example.com/CamelCase.
        - `hostnameGeneratorRef` object, required
          - `coreName` string, required
      - `meshServices` object[]: MeshServices is a list of matched MeshServices
        - `mesh` string, required
        - `name` string, required: Name is a core name of MeshService
        - `namespace` string, required
        - `zone` string, required
      - `vips` object[]: VIPs is a list of assigned Kuma VIPs.
        - `ip` string
  - `total` number: The total number of entities
  - `next` string: URL to the next page

## Changes

- **2026-08-18** `658ffb748f95`: 1 info
  - added the optional property `items/items/snis` to the response with the `200` status
- **2026-02-16** `106b373707f3`: 1 info
  - added the optional property `items/items/status/conditions` to the response with the `200` status
- **2025-11-06** `5d2b35832e3f`: 1 info
  - added the optional property `items/items/kri` to the response with the `200` status
- **2025-10-02** `ecce2daf9de6`: 1 breaking
  - the response property `items/items/spec/selector/meshService/matchLabels` became optional for the status `200`

[Operation history](https://skmtc.dev/kong/apis/konnect-api-beta/changes/v1/mesh/control-planes/:cpId/api/meshes/:mesh/meshmultizoneservices/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.dev/kong/apis/konnect-api-beta/revisions/cef0f947e9c9?raw)