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

---

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