---
title: "List Shadow Link Topics"
method: GET
path: "/v1/shadow-links/{shadow_link_name}/topic"
tags: ["Shadow Links (Data Plane)"]
---

# List Shadow Link Topics

`GET /v1/shadow-links/{shadow_link_name}/topic`

List shadow topic status information for a specific shadow link. Optional: filter based on topic name.

## Path parameters

- `shadow_link_name` string, required

## Query parameters

- `filter.topic_name_contains` string
- `page_size` integer
- `page_token` string

## Response `200`

OK

- ListShadowLinkTopicsResponse
  - `next_page_token` string
  - `shadow_topics` V1ShadowTopic[]
    - `partitions` TopicPartitionInformation[]
      - `high_watermark` string, int64
      - `partition_id` string, int64
      - `source_high_watermark` string, int64
      - `source_last_stable_offset` string, int64
      - `source_last_updated_timestamp` string, date-time
    - `state` 'SHADOW_TOPIC_STATE_ACTIVE' | 'SHADOW_TOPIC_STATE_FAULTED' | 'SHADOW_TOPIC_STATE_PAUSED' | 'SHADOW_TOPIC_STATE_FAILING_OVER' | 'SHADOW_TOPIC_STATE_FAILED_OVER' | 'SHADOW_TOPIC_STATE_PROMOTING' | 'SHADOW_TOPIC_STATE_PROMOTED' — - SHADOW_TOPIC_STATE_ACTIVE: Shadow topic is active - SHADOW_TOPIC_STATE_FAULTED: Shadow topic has faulted - SHADOW_TOPIC_STATE_PAUSED: Shadow topic has been paused - SHADOW_TOPIC_STATE_FAILING_OVER: Shadow topic is in the process of failing over - SHADOW_TOPIC_STATE_FAILED_OVER: Shadow topic has failed over successfully - SHADOW_TOPIC_STATE_PROMOTING: Shadow topic is in the process of being promoted - SHADOW_TOPIC_STATE_PROMOTED: Shadow topic is promoted successfully
    - `topic_id` string
    - `topic_name` string
    - `total_lag` string, int64
    - `total_partitions` integer

## Other responses

- `401` — Unauthenticated.
- `500` — Internal Server Error. Reach out to support.
- `default` — An unexpected error response.

## Changes

- **2025-12-11** `0a5af046f9de` — 2 info
  - api tag `Shadow Links (Data Plane)` added
  - api tag `Shadow Links (Dataplane)` removed
- **2025-12-11** `d6b328d69cf2` — 1 info
  - endpoint added
- **2025-05-27** `dfa71f9d277e` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/redpanda-data/apis/redpanda-cloud-data-plane-api/changes/v1/shadow-links/:shadow_link_name/topic/get.md)

---

[API](https://skmtc.dev/redpanda-data/apis/redpanda-cloud-data-plane-api.md) · [All operations](https://skmtc.dev/redpanda-data/apis/redpanda-cloud-data-plane-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/redpanda-data/redpanda-cloud-data-plane-api/revisions/7eef0bcc42e7/schema)