Skip to main content
GET
/
v2
/
sessions
List Sessions (Enriched)
curl --request GET \
  --url https://api.toughtongueai.com/api/public/v2/sessions \
  --header 'Authorization: Bearer <token>'
{
  "sessions": [
    {
      "id": "session_abc123",
      "scenario_id": "scenario_xyz",
      "scenario_name": "Sales Cold Call",
      "user_email": "user@example.com",
      "duration_seconds": 180,
      "duration_minutes": 3.0,
      "status": "completed",
      "evaluation_score": 85,
      "evaluation_note": "Strong performance overall",
      "report_card": {
        "topics": [
          {
            "name": "Opening",
            "score": 90,
            "note": "Clear and confident introduction"
          }
        ]
      },
      "report_card_topics": "Opening;Objection Handling;Closing",
      "analytics_url": "https://app.toughtongueai.com/analysis/session_abc123",
      "created_at": "2024-01-15T10:30:00Z"
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 50
}
List sessions with additional evaluation and analytics data. Returns the same structure as CSV exports with evaluation scores and report cards.
​
scenario_id
string
Filter by scenario ID
​
user_email
string
Filter by user email (comma-separated for multiple)
​
from_date
string
Filter from date (ISO format: YYYY-MM-DD or YYYY-MM-DDTHH:MM:SSZ)
​
to_date
string
Filter to date (ISO format: YYYY-MM-DD or YYYY-MM-DDTHH:MM:SSZ)
​
is_org
boolean
default:"false"
Use admin access for org-wide data (requires org context)
​
page
integer
default:"1"
Page number (starts at 1)
​
limit
integer
default:"50"
Items per page (max 500)
{
  "sessions": [
    {
      "id": "session_abc123",
      "scenario_id": "scenario_xyz",
      "scenario_name": "Sales Cold Call",
      "user_email": "user@example.com",
      "duration_seconds": 180,
      "duration_minutes": 3.0,
      "status": "completed",
      "evaluation_score": 85,
      "evaluation_note": "Strong performance overall",
      "report_card": {
        "topics": [
          {
            "name": "Opening",
            "score": 90,
            "note": "Clear and confident introduction"
          }
        ]
      },
      "report_card_topics": "Opening;Objection Handling;Closing",
      "analytics_url": "https://app.toughtongueai.com/analysis/session_abc123",
      "created_at": "2024-01-15T10:30:00Z"
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 50
}