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

# Returns a list of HostnameGenerator in the mesh.

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

## Query parameters

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

## Response `200`

List

- object
  - `items` HostnameGeneratorItem[], nullable
    - `type` 'HostnameGenerator', required — the type of the resource
    - `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
    - `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 HostnameGenerator resource.
      - `extension` object — Extension struct for a plugin configuration
        - `config` unknown
        - `type` string, required — Type of the extension.
      - `selector` object
        - `meshExternalService` object
          - `matchLabels` object
        - `meshMultiZoneService` object
          - `matchLabels` object
        - `meshService` object
          - `matchLabels` object
      - `template` string, required
    - `creationTime` string, date-time — Time at which the resource was created
    - `modificationTime` string, date-time — Time at which the resource was updated
  - `total` number, nullable — The total number of entities
  - `next` string, nullable — URL to the next page

## Changes

- **2025-11-06** `5d2b35832e3f` — 1 info
  - added the optional property `items/items/kri` to the response with the `200` status
- **2025-10-02** `ecce2daf9de6` — 4 breaking, 1 info
  - the response property `items` became nullable for the status `200`
  - the response property `items/items/spec/extension/config` became nullable for the status `200`
  - the response property `next` became nullable for the status `200`
  - the response property `total` became nullable for the status `200`
  - …1 more
- **2025-06-05** `a0a9c5c8afa2` — 1 info
  - added the optional property `items/items/spec/extension` to the response with the `200` status

[Change history](https://skmtc.dev/kong/apis/konnect-api-beta/changes/v1/mesh/control-planes/:cpId/api/hostnamegenerators/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)