Skip to main content
GET
Get Chat History
Retrieves paginated chat message history for a chat session. Messages are returned newest-first.

Usage

Path Parameters

Query Parameters

Response

Returns a bare JSON array of message objects:

Message Roles

Content Types

Pagination

Use the created_at timestamp of the oldest message in the current page as the before cursor for the next page:

Notes

Authentication required. The authenticated user must own the chat session.

Authorizations

Authorization
string
header
required

API token generated from your Splox account settings. Create tokens at https://app.splox.io/account?tab=settings

Path Parameters

chatId
string<uuid>
required

Chat ID

Query Parameters

limit
integer
default:50

Messages per page (default: 50, max: 200)

Required range: x <= 200
before
string<date-time>

RFC3339 timestamp cursor for backward pagination. Omit to get latest messages.

Response

200 - application/json

Chat messages retrieved successfully (bare JSON array)

id
string<uuid>
required
chat_id
string<uuid>
required
role
enum<string>
required
Available options:
user,
assistant,
system,
tool
content
object[]
required
parent_id
string<uuid> | null
status
object | null
metadata
object | null
files
object[] | null
created_at
string<date-time>
updated_at
string<date-time>