Skip to main content
GET
/
v1
/
sessions
/
{sessionId}
curl --request GET \
  --url https://api.synthra.ai/v1/sessions/session_abc123def456 \
  --header 'Authorization: Bearer synthra_live_abc123def456'

{
  "sessionId": "session_abc123def456",
  "userId": "user_9f8e7d6c5b4a",
  "createdAt": "2024-03-08T14:30:00Z",
  "expiresAt": "2024-03-09T14:30:00Z",
  "lastActivity": "2024-03-08T15:45:23Z",
  "messageCount": 15,
  "tokenUsage": {
    "total": 1847,
    "prompt": 923,
    "completion": 924
  },
  "metadata": {
    "source": "web",
    "language": "en"
  }
}

​
Authorization

​
Authorization
string
required
Bearer token. Format: Bearer synthra_live_abc123def456

​
Path Parameters

​
sessionId
string
required
Unique session identifier. Format: session_<16 chars>

​
Response

​
sessionId
string
Unique session identifier
​
userId
string
User identifier associated with this session
​
createdAt
string
ISO 8601 timestamp of session creation
​
expiresAt
string
ISO 8601 timestamp when session will auto-expire
​
lastActivity
string
ISO 8601 timestamp of last message
​
messageCount
number
Total number of messages in session
​
tokenUsage
object
Token usage statistics
​
metadata
object
Custom metadata attached to session
curl --request GET \
  --url https://api.synthra.ai/v1/sessions/session_abc123def456 \
  --header 'Authorization: Bearer synthra_live_abc123def456'

{
  "sessionId": "session_abc123def456",
  "userId": "user_9f8e7d6c5b4a",
  "createdAt": "2024-03-08T14:30:00Z",
  "expiresAt": "2024-03-09T14:30:00Z",
  "lastActivity": "2024-03-08T15:45:23Z",
  "messageCount": 15,
  "tokenUsage": {
    "total": 1847,
    "prompt": 923,
    "completion": 924
  },
  "metadata": {
    "source": "web",
    "language": "en"
  }
}