---
title: "GET /v2/threads/{threadId}/messages/{messageId}"
method: GET
path: "/v2/threads/{threadId}/messages/{messageId}"
---

# GET /v2/threads/{threadId}/messages/{messageId}

`GET /v2/threads/{threadId}/messages/{messageId}`

## Request

- Base URL: `https://api.langtail.com`
- URL: `https://api.langtail.com/v2/threads/{threadId}/messages/{messageId}`
- Auth: none declared. Required headers: `X-API-Key`

Retrieves a specific message from a thread.

## Path parameters

- `threadId` string, required
- `messageId` string, required

## Headers

- `X-API-Key` string, required

## Response `200`

Successful response

- object
  - `id` string, required: The unique identifier for the message.
  - `createdAt` string, date-time, required: The timestamp when the message was created.
  - `threadId` string, required: The ID of the thread this message belongs to.
  - `content` object[]: Additional messages. These will be appended to the Prompt Template.
    - `role` 'assistant' | 'user' | 'system' | 'function' | 'tool', required
    - `content` union, required
      - string: Text content
      - union[]: Mix of text and images.
        - union
          - object
            - `type` 'text', required
            - `text` string, required
          - object
            - `type` 'image_url', required
            - `image_url` object, required
              - …
      - unknown
    - `function_call` object
      - `name` string, required
      - `arguments` string, required
    - `tool_calls` object[]
      - `id` string, required
      - `type` 'function', required
      - `function` object, required
        - `name` string, required
        - `arguments` string, required
    - `tool_choice` union
      - 'auto'
      - 'none'
      - object
        - `type` 'function', required
        - `function` object, required
          - `name` string, required
    - `tool_call_id` string
  - `metadata` object, nullable: A key-value store for additional metadata associated with the message.
  - `requestLog` object, nullable: Information about the request log, if available.
    - `id` string: The unique identifier for the request log.
    - `createdAt` string, date-time: The timestamp when the request log was created.
    - `request` object: Details of the request made.
    - `response` object: Details of the response received.
  - `requestLogId` string, nullable: The unique identifier for the request log, if available.

## Other responses

- `404`: Not found

---

[API](https://skmtc.dev/langtail/apis/langtail-prompt-endpoint.md) - [All operations](https://skmtc.dev/langtail/apis/langtail-prompt-endpoint/llms.txt) - [OpenAPI document](https://skmtc.dev/langtail/apis/langtail-prompt-endpoint/revisions/7186c80b2e39?raw)