Skip to main content
GET
/
sessions
/
{id}
Get a session
curl --request GET \
  --url https://api.vocobase.com/api/v2/sessions/{id} \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": {
    "session_id": "s1234567-abcd-1234-abcd-123456789012",
    "agent_id": "a1234567-abcd-1234-abcd-123456789012",
    "agent_name": "Sales Assistant",
    "status": "completed",
    "duration_seconds": 127,
    "credits_used": 2.12,
    "transcript": [
      {
        "role": "bot",
        "content": "Hello! How can I help?",
        "timestamp": "2026-05-02T14:30:01.000Z"
      },
      {
        "role": "user",
        "content": "Tell me about your enterprise plan.",
        "timestamp": "2026-05-02T14:30:04.000Z"
      }
    ],
    "recording_url": "https://storage.googleapis.com/vocobase-recordings/rec_abc123.wav?X-Goog-Signature=...",
    "variables": {
      "callee_name": "Sajal"
    },
    "started_at": "2026-05-02T14:30:00.000Z",
    "ended_at": "2026-05-02T14:32:07.000Z"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.vocobase.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

API key in format: rg_live_xxxx. Pass as a Bearer token in the Authorization header.

Path Parameters

​
id
string<uuid>
required

Session ID (returned by /sessions/webrtc or /calls/start).

Response

Session retrieved.

​
success
boolean
​
data
object