---
title: "Get a message by its ID"
method: GET
path: "/api/message/{message_id}"
tags: ["Message"]
---

# Get a message by its ID

`GET /api/message/{message_id}`

Quickly get the full object for a given message. From the message, you can get the topic and all messages which exist on that topic.

## Path parameters

- `message_id` string, uuid, required

## Headers

- `TR-Dataset` string, uuid, required

## Response `200`

Message with the given ID

- Message
  - `completion_tokens` integer, nullable
  - `content` string, required
  - `created_at` string, date-time, required
  - `dataset_id` string, uuid, required
  - `deleted` boolean, required
  - `id` string, uuid, required
  - `prompt_tokens` integer, nullable
  - `role` string, required
  - `sort_order` integer, required
  - `topic_id` string, uuid, required
  - `updated_at` string, date-time, required

## Other responses

- `400` — Service error relating to getting the message

---

[API](https://skmtc.net/devflowinc/apis/trieve-api.md) · [All operations](https://skmtc.net/devflowinc/apis/trieve-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/devflowinc/trieve-api/revisions/84583e7c9fc1/schema)
