---
title: "Changes to List Custom Domains"
method: GET
path: "/v2/cloud-gateways/custom-domains"
---

# Changes to List Custom Domains

`GET /v2/cloud-gateways/custom-domains`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 7 of 75 revisions.

- **2026-04-17** `c80d57ed14ab` — 1 breaking
- **2026-03-30** `6dabb1df19ab` — 1 info
- **2025-10-23** `8ab3ec3ed301` — 1 warning
- **2025-09-16** `ddf026fbd25b` — 1 warning, 3 info
- **2025-08-22** `3c0154b2053a` — 11 breaking
- **2025-08-14** `6333a0d3b095` — 1 breaking
- **2025-07-22** `76b0fefddb0d` — 1 warning

## Changes

- **2026-04-17** `c80d57ed14ab` — 1 breaking
  - for the `query` request parameter `filter`, the type/format of property `domain` was specialized from ``/`` to `object`/``
- **2026-03-30** `6dabb1df19ab` — 1 info
  - added the optional property `data/items/kind` to the response with the `200` status
- **2025-10-23** `8ab3ec3ed301` — 1 warning
  - added the new `type` enum value to the `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterStandard]/rule` response property for the response status `400`
- **2025-09-16** `ddf026fbd25b` — 1 warning, 3 info
  - added the new `sg` enum value to the `data/items/control_plane_geo` response property for the response status `200`
  - added the enum value `sg` to the property `control_plane_geo/oneOf[subschema #1: ControlPlaneGeoFieldEqualsFilter]/oneOf[subschema #1: Control-Plane Geo]/` of the `query` request parameter `filter`
  - added the enum value `sg` to the property `control_plane_geo/oneOf[subschema #1: ControlPlaneGeoFieldEqualsFilter]/oneOf[subschema #2: ControlPlaneGeoFieldEqualsComparison]/eq` of the `query` request parameter `filter`
  - added the enum value `sg` to the property `control_plane_geo/oneOf[subschema #2: ControlPlaneGeoFieldNotEqualsFilter]/neq` of the `query` request parameter `filter`
- **2025-08-22** `3c0154b2053a` — 11 breaking
  - the response property `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterChoiceItem]/source` became nullable for the status `400`
  - the response property `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterDependentItem]/source` became nullable for the status `400`
  - the response property `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterMaximumLength]/source` became nullable for the status `400`
  - the response property `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterMinimumLength]/source` became nullable for the status `400`
  - the response property `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterStandard]/source` became nullable for the status `400`
  - the response property `data/items/state_metadata/reason` became nullable for the status `200`
  - the response property `data/items/state_metadata/reported_status` became nullable for the status `200`
  - the response property `detail` became nullable for the status `401`
  - the response property `instance` became nullable for the status `401`
  - the response property `status` became nullable for the status `401`
  - the response property `title` became nullable for the status `401`
- **2025-08-14** `6333a0d3b095` — 1 breaking
  - for the `query` request parameter `filter`, the type/format of property `control_plane_id` was specialized from ``/`` to `object`/``
- **2025-07-22** `76b0fefddb0d` — 1 warning
  - for the `query` request parameter `filter`, the type/format of property `control_plane_id` was changed from `object`/`` to ``/``

---

[Operation](https://skmtc.dev/kong/apis/konnect-api-go-sdk/docs/v2/cloud-gateways/custom-domains/get.md) · [API](https://skmtc.dev/kong/apis/konnect-api-go-sdk.md) · [Page](https://skmtc.dev/kong/apis/konnect-api-go-sdk/changes/v2/cloud-gateways/custom-domains/get)