---
title: "GET /sm/getMessages/{topic}/{offset}"
method: GET
path: "/sm/getMessages/{topic}/{offset}"
tags: ["Secure Messaging"]
---

# GET /sm/getMessages/{topic}/{offset}

`GET /sm/getMessages/{topic}/{offset}`

## Request

- Base URL: `https://unifieddatalibrary.com`
- URL: `https://unifieddatalibrary.com/sm/getMessages/{topic}/{offset}`
- Auth: none declared

Retrieve a set of messages from the given topic at the given offset. See Help > Secure Messaging API on Storefront for more details on how to use getMessages.

## Path parameters

- `offset` integer, required
- `topic` string, required

## Query parameters

- `firstResult` integer
- `maxResults` integer

## Response `200`

OK

## 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`: 5 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 `429`
  - …1 more
- **2025-05-29** `4e1cbc17e814`: 2 info
  - added the new optional `query` request parameter `firstResult`
  - added the new optional `query` request parameter `maxResults`
- **2025-04-16** `75f764c843a9`: 2 breaking, 2 warning
  - added the new path request parameter `offset`
  - added the new path request parameter `topic`
  - deleted the `query` request parameter `offset`
  - deleted the `query` request parameter `topic`
- **2025-03-04** `53ced4917cd1`: 2 breaking, 2 warning
  - added the new required `query` request parameter `offset`
  - added the new required `query` request parameter `topic`
  - deleted the `path` request parameter `offset`
  - deleted the `path` request parameter `topic`

[Operation history](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/changes/sm/getMessages/:topic/:offset/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)