---
title: "Browse topics grouped by source"
method: GET
path: "/topics/catalog/grouped"
tags: ["Topics"]
---

# Browse topics grouped by source

`GET /topics/catalog/grouped`

Get topics grouped by source connector for the SQL Studio tree sidebar.

## Query parameters

- `search` string, nullable — Partial topic name search
- `source_id` string, nullable — Filter to a single source/producer ID

## Response `200`

Successful Response

- KafkaTopicCatalogGroupedRes — Grouped catalog response - sources with their topics.
  - `groups` KafkaTopicCatalogGroup[]
    - `group_id` string, required — Producer entity ID (or '__dlq__' for DLQ group)
    - `group_name` string, required — Display name for the group
    - `group_type` string, required — Producer type: sources, destinations, transforms, dlq, manual
    - `connector` string, nullable — Connector type (postgresql, snowflake, etc.)
    - `topic_count` integer
    - `topics` KafkaTopicCatalogGroupTopic[]
      - `topic_id` string, required — Full Kafka topic name
      - `short_name` string, required — Display name with source prefix stripped (e.g., public.users)
      - `partition_count` integer
      - `value_format` 'avro' | 'json' | 'json_schema' | 'protobuf' | 'string' | 'bytearray' | 'unknown' — Human-readable serialization format names for API responses.
      - `is_dlq` boolean — Whether this is a dead letter queue topic
  - `total_topics` integer
  - `total_groups` integer

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/streamkap/apis/streamkap-rest-api.md) · [All operations](https://skmtc.net/streamkap/apis/streamkap-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/streamkap/streamkap-rest-api/versions/8aea6143d003/schema)