---
title: "Get Session History"
method: GET
path: "/v1/messages/sessions/{session_id}"
tags: ["v1", "Messages"]
---

# Get Session History

`GET /v1/messages/sessions/{session_id}`

Retrieve message history for a specific conversation session.
    
    **Authentication Required**: Bearer token, API key, or session token
    
    **Pagination**:
    - Use `limit` and `skip` parameters for pagination
    - Messages are returned in chronological order (oldest first)
    - `total_count` indicates total messages in the session
    
    **Access Control**:
    - Only returns messages for the authenticated user
    - Workspace scoping is applied if available

## Path parameters

- `session_id` string, required

## Query parameters

- `limit` integer — Maximum number of messages to return
- `skip` integer — Number of messages to skip for pagination

## Response `200`

Message history retrieved

- MessageHistoryResponse — Response model for retrieving message history
  - `sessionId` string, required — Session ID of the conversation
  - `messages` MessageResponse[], required — List of messages in chronological order
    - `objectId` string, required — Parse Server objectId of the stored message
    - `sessionId` string, required — Session ID of the conversation
    - `role` 'user' | 'assistant', required — Role of the message sender
    - `content` union, required — Content of the message - can be a simple string or structured content objects
      - string
      - object[]
    - `createdAt` string, date-time, required — When the message was created
    - `processing_status` string — Status of background processing (queued, analyzing, completed, failed)
  - `total_count` integer, required — Total number of messages in the session

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Session not found
- `422` — Validation Error
- `500` — Internal server error

## Changes

- **2025-11-07** `14ff13755871` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/papr-ai/apis/papr-memory-api/changes/v1/messages/sessions/:session_id/get.md)

---

[API](https://skmtc.dev/papr-ai/apis/papr-memory-api.md) · [All operations](https://skmtc.dev/papr-ai/apis/papr-memory-api/llms.txt) · [OpenAPI document](https://skmtc.dev/papr-ai/apis/papr-memory-api/revisions/34b5e739fd20?raw)