---
title: "GET /gateway/v2/alias-topic"
method: GET
path: "/gateway/v2/alias-topic"
tags: ["cli_alias-topic_gateway_v2_8"]
---

# GET /gateway/v2/alias-topic

`GET /gateway/v2/alias-topic`

## Request

- Base URL: `https://developers.conduktor.io` (the document declares no server; this is the origin it was published from)
- URL: `https://developers.conduktor.io/gateway/v2/alias-topic`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/conduktor/apis/conduktor-gateway-api/docs/gateway/v2/alias-topic/get.ts> (a function with typed inputs; its response is checked against the schema)

[![Generally Available](https://img.shields.io/badge/Lifecycle-Generally%20Available-blue)](#tag/Versioning)

List the alias topics of a virtual cluster

## Query parameters

- `vcluster` string
- `name` string
- `showDefaults` boolean

## Response `200`

- AliasTopic[]
  - `kind` string, required: The kind of the alias topic
  - `apiVersion` string, required: The api version of the alias topic
  - `metadata` AliasTopicMetadata, required: The metadata of the alias topic
    - `name` string, ^[a-zA-Z0-9._-]+$, required: The name of the alias topic
    - `vCluster` string, ^[a-zA-Z0-9._-]+$: The virtual cluster of the alias topic (default: `passthrough`)
  - `spec` AliasTopicSpec, required: The specification of the alias topic
    - `physicalName` string, ^[a-zA-Z0-9._-]+$, required: The physical name of the alias topic
    - `physicalCluster` string: The physical kafka cluster hosting the physical topic. The field is optional and only useful for alias topics referencing __Partner__ virtual clusters. For alias topics linked to virtual clusters of type __Standard__, the physical cluster can only be "main" (automatically set to "main" if the field is missing). The physical cluster must be one of the configured list of physical clusters of the gateway.

## Other responses

- `400`: The request is not valid
- `401`: The given credentials are not valid
- `404`: The given virtual cluster does not exist
- `500`: An unexpected error occurred in the server

---

[API](https://skmtc.dev/conduktor/apis/conduktor-gateway-api.md) - [All operations](https://skmtc.dev/conduktor/apis/conduktor-gateway-api/llms.txt) - [OpenAPI document](https://skmtc.dev/conduktor/apis/conduktor-gateway-api/revisions/73ad742aa630?raw)