> ## Documentation Index
> Fetch the complete documentation index at: https://artie.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List Kafka topics

> Retrieves the light topic list for the cluster (no per-topic detail fetch). Results are cached for two minutes unless forceRefresh is true. Includes the owning source reader name and table name when the topic belongs to an Artie pipeline.



## OpenAPI

````yaml https://raw.githubusercontent.com/artie-labs/artie-api-spec/refs/heads/master/openapi.yaml get /kafka-clusters/{uuid}/topics
openapi: 3.1.0
info:
  description: External API endpoints for Artie
  title: Artie API
  version: v1.0.130
servers:
  - url: https://api.artie.com
security:
  - ApiKey: []
paths:
  /kafka-clusters/{uuid}/topics:
    get:
      tags:
        - Kafka Clusters
      summary: List Kafka topics
      description: >-
        Retrieves the light topic list for the cluster (no per-topic detail
        fetch). Results are cached for two minutes unless forceRefresh is true.
        Includes the owning source reader name and table name when the topic
        belongs to an Artie pipeline.
      operationId: kafka_topic_list
      parameters:
        - in: path
          name: uuid
          required: true
          schema:
            type: string
        - in: query
          name: forceRefresh
          schema:
            type: boolean
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListResponseBodyKafkaTopic'
          description: OK
        '404':
          description: Not Found
        '500':
          description: Internal Server Error
components:
  schemas:
    ListResponseBodyKafkaTopic:
      properties:
        items:
          items:
            $ref: '#/components/schemas/PayloadsKafkaTopic'
          type: array
      required:
        - items
      type: object
    PayloadsKafkaTopic:
      properties:
        artieManaged:
          description: >-
            Whether Artie manages this topic: a CDC topic under the company
            prefix outside the customer namespace, or a Kafka-internal __ topic.
          type: boolean
        partitionCount:
          type: integer
        retentionMS:
          type: string
        sourceName:
          type: string
        tableName:
          type: string
        topic:
          type: string
      required:
        - topic
        - retentionMS
        - partitionCount
        - artieManaged
      type: object
  securitySchemes:
    ApiKey:
      description: API key passed as a Bearer token in the Authorization header.
      scheme: bearer
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.