---
title: "Browse topics for SQL Studio"
method: GET
path: "/topics/catalog"
tags: ["Topics"]
---

# Browse topics for SQL Studio

`GET /topics/catalog`

Get a browsable catalog of topics with schema metadata for the Query Playground.

## Query parameters

- `page` integer
- `page_size` integer
- `search` string, nullable — Partial topic name search
- `value_format` string, nullable — Filter by serialization format (avro, json, protobuf, etc.)

## Response `200`

Successful Response

- KafkaTopicCatalogRes — Paginated topic catalog response.
  - `page` integer — Current page number
  - `page_size` integer — Results per page
  - `total` integer, nullable — Total number of results
  - `has_next` boolean, nullable — Whether more pages exist
  - `result` KafkaTopicCatalogEntry[], required
    - `topic_id` string, required — Kafka topic name (e.g., source_abc.public.users)
    - `display_name` string, required — Short display name for the sidebar
    - `partition_count` integer — Number of partitions
    - `value_format` 'avro' | 'json' | 'json_schema' | 'protobuf' | 'string' | 'bytearray' | 'unknown' — Human-readable serialization format names for API responses.
    - `schema_fields` object[], nullable — Schema fields from Schema Registry (list of {name, type} dicts), or None if no schema
    - `entity_type` string, nullable — Producer type: sources, transforms, manual
    - `entity_id` string, nullable — Producer entity ID
    - `entity_name` string, nullable — Producer entity display name

## 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/revisions/e9ce8221bac6/schema)