---
title: "GET /sm/listTopics"
method: GET
path: "/sm/listTopics"
tags: ["Secure Messaging"]
---

# GET /sm/listTopics

`GET /sm/listTopics`

## Request

- Base URL: `https://unifieddatalibrary.com`
- URL: `https://unifieddatalibrary.com/sm/listTopics`
- Auth: none declared

Retrieve the list of available secure messaging topics or data types available.

## Response `200`

OK

- TopicDetails[]
  - `topic` string: The name of the topic in kafka.
  - `minPos` integer: The minimum (oldest) kafka offset for this topic.
  - `maxPos` integer: The maximum (latest) kafka offset for this topic.
  - `udlOpenAPISchema` string: The UDL schema that the objects in this topic apply to.
  - `description` string: A description of the data content of this topic.

## Other responses

- `400`: Bad Request
- `401`: Invalid/Missing User Credentials
- `403`: User Is Not Authorized
- `404`: Unable to reconcile topic:
- `429`: Rate of Requests Exceeds Allowed Limit
- `500`: Internal Server Error

## Changes

> 12 revisions in range; 1 could not be searched.

- **2025-09-26** `45631f9bb3f0`: 6 info
  - added the non-success response with the status `400`
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
  - added the non-success response with the status `404`
  - …2 more

[Operation history](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/changes/sm/listTopics/get.md)

---

[API](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api.md) - [All operations](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/revisions/bd17bc53681e?raw)
