---
title: "Topic List"
method: POST
path: "/api/v1.msgs.topic.list"
tags: ["Msgs"]
---

# Topic List

`POST /api/v1.msgs.topic.list`

List available topics in the given namespace

## Request body

- MsgTopicListIn
  - `namespace` string, nullable
  - `consistency` 'strong' | 'weak' — Consistency level for reads. Strong consistency (also known as linearizability) guarantees that a read will see all previous writes. Weak consistency allows stale reads, but can save one or more round trip to the leader.
  - `limit` integer — Limit the number of returned items
  - `iterator` string, nullable — The iterator returned from a prior invocation

## Response `200`

- ListResponseMsgTopicListOut
  - `data` MsgTopicListOut[], required
    - `id` string, required
    - `name` string, required
    - `partitions` integer, required
  - `iterator` string, nullable
  - `prev_iterator` string, nullable
  - `done` boolean, required

## Other responses

- `400`
- `401`
- `403`
- `422`

## Changes

- **2026-10-07** `2f4a6027abc1` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/svix/apis/diom-api/changes/api/v1.msgs.topic.list/post.md)

---

[API](https://skmtc.dev/svix/apis/diom-api.md) · [All operations](https://skmtc.dev/svix/apis/diom-api/llms.txt) · [OpenAPI document](https://skmtc.dev/svix/apis/diom-api/revisions/c60db8e37b8c?raw)