curl --request GET \
--url 'https://api.synthra.ai/v1/sessions/session_abc123def456/messages?limit=20' \
--header 'Authorization: Bearer synthra_live_abc123def456'
const response = await fetch(
'https://api.synthra.ai/v1/sessions/session_abc123def456/messages?limit=20',
{
headers: {
'Authorization': `Bearer ${process.env.SYNTHRA_API_KEY}`
}
}
);
import requests
response = requests.get(
'https://api.synthra.ai/v1/sessions/session_abc123def456/messages',
headers={
'Authorization': f'Bearer {api_key}'
},
params={
'limit': 20
}
)
{
"data": [
{
"messageId": "msg_abc123def456",
"sessionId": "session_abc123def456",
"role": "user",
"content": "Hello, Synthra!",
"tokens": 4,
"createdAt": "2024-03-08T14:30:00Z"
},
{
"messageId": "msg_xyz789ghi012",
"sessionId": "session_abc123def456",
"role": "assistant",
"content": "Hello! How can I help you today?",
"tokens": 8,
"createdAt": "2024-03-08T14:30:01Z"
}
],
"pagination": {
"hasMore": true,
"nextCursor": "msg_xyz789ghi012"
}
}
Message Operations
Get Message History
Retrieve conversation history for a session
GET
/
v1
/
sessions
/
{sessionId}
/
messages
curl --request GET \
--url 'https://api.synthra.ai/v1/sessions/session_abc123def456/messages?limit=20' \
--header 'Authorization: Bearer synthra_live_abc123def456'
const response = await fetch(
'https://api.synthra.ai/v1/sessions/session_abc123def456/messages?limit=20',
{
headers: {
'Authorization': `Bearer ${process.env.SYNTHRA_API_KEY}`
}
}
);
import requests
response = requests.get(
'https://api.synthra.ai/v1/sessions/session_abc123def456/messages',
headers={
'Authorization': f'Bearer {api_key}'
},
params={
'limit': 20
}
)
{
"data": [
{
"messageId": "msg_abc123def456",
"sessionId": "session_abc123def456",
"role": "user",
"content": "Hello, Synthra!",
"tokens": 4,
"createdAt": "2024-03-08T14:30:00Z"
},
{
"messageId": "msg_xyz789ghi012",
"sessionId": "session_abc123def456",
"role": "assistant",
"content": "Hello! How can I help you today?",
"tokens": 8,
"createdAt": "2024-03-08T14:30:01Z"
}
],
"pagination": {
"hasMore": true,
"nextCursor": "msg_xyz789ghi012"
}
}
Authorization
string
required
Bearer token. Format:
Bearer synthra_live_abc123def456Path Parameters
string
required
Unique session identifier. Format:
session_<16 chars>Query Parameters
number
default:"50"
Maximum number of messages to return. Max: 100
string
Cursor for pagination. Use
nextCursor from previous response.string
default:"desc"
Sort order. Options:
asc, descResponse
array
Array of message objects
object
Pagination metadataProperties:
hasMore(boolean): Whether more messages existnextCursor(string): Cursor for next page
curl --request GET \
--url 'https://api.synthra.ai/v1/sessions/session_abc123def456/messages?limit=20' \
--header 'Authorization: Bearer synthra_live_abc123def456'
const response = await fetch(
'https://api.synthra.ai/v1/sessions/session_abc123def456/messages?limit=20',
{
headers: {
'Authorization': `Bearer ${process.env.SYNTHRA_API_KEY}`
}
}
);
import requests
response = requests.get(
'https://api.synthra.ai/v1/sessions/session_abc123def456/messages',
headers={
'Authorization': f'Bearer {api_key}'
},
params={
'limit': 20
}
)
{
"data": [
{
"messageId": "msg_abc123def456",
"sessionId": "session_abc123def456",
"role": "user",
"content": "Hello, Synthra!",
"tokens": 4,
"createdAt": "2024-03-08T14:30:00Z"
},
{
"messageId": "msg_xyz789ghi012",
"sessionId": "session_abc123def456",
"role": "assistant",
"content": "Hello! How can I help you today?",
"tokens": 8,
"createdAt": "2024-03-08T14:30:01Z"
}
],
"pagination": {
"hasMore": true,
"nextCursor": "msg_xyz789ghi012"
}
}