Get Session | Neurologyca

curl https://softskills-api-b1f382ab39be.herokuapp.com/api/v1/sessions/session_id \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json"

{
  "sessionId": "a3f47b2e-9c4d-4f1a-8b2e-7d9f3c1a2b4e",
  "module": "api",
  "status": "COMPLETE",
  "createdAt": "2024-01-15T09:30:00Z",
  "updatedAt": "2024-01-15T10:15:00Z",
  "videoAnalysis": {
    "overall_score": 78.5,
    "category_scores": {
      "likeability": 7.8,
      "authenticity": 8.2,
      "clarity": 7.5,
      "confidence": 7.9
    },
    "strengths": [
      "Clear articulation",
      "Engaging tone"
    ],
    "areas_for_improvement": [
      "Reduce filler words",
      "Increase eye contact"
    ],
    "filler_word_count": 12,
    "speaking_pace_wpm": 130.4,
    "labeled_moments": [
      {
        "timestamp": "00:01:15",
        "label": "Pause",
        "text": "Brief pause before key point"
      },
      {
        "timestamp": "00:03:42",
        "label": "Smile",
        "text": "Genuine smile during introduction"
      }
    ],
    "time_series_scores": [
      {
        "timestamp": "00:00:30",
        "likeability": 7.5,
        "authenticity": 8,
        "clarity": 7.2,
        "confidence": 7.6
      },
      {
        "timestamp": "00:02:00",
        "likeability": 8,
        "authenticity": 8.3,
        "clarity": 7.8,
        "confidence": 8.1
      }
    ],
    "detailed_feedback": "The speaker demonstrated strong clarity and confidence throughout the session, with minor issues related to filler words and occasional pacing inconsistencies.",
    "session_summary": "Overall, a confident and engaging presentation with room to improve pacing and reduce filler words.",
    "recommendation": "Practice reducing filler words by pausing briefly instead of using 'um' or 'uh', and maintain steady eye contact to enhance engagement."
  }
}

Returns the full analysis result for a specific session, including all scores, feedback, labeled moments, time-series data, and recommendations.

Authentication

AuthorizationBearer

Your API key (e.g. ng_xxx…). The Try it and generated code send it as Authorization: Bearer <key>. Alternatively use the X-API-Key header with the raw key.

Path parameters

session_idstringRequired

The session ID returned by POST /api/v1/analyze-video.

Response

Full session details

sessionIdstring

Unique session identifier.

modulestring

The source of the session (e.g. api, live-practice).

statusstring

Session status — PROCESSING or COMPLETE.

createdAtdatetime

When the session was created (ISO 8601).

updatedAtdatetime

When the session was last updated (ISO 8601).

videoAnalysisobject or null

Full analysis result stored for this session.

Errors

401

Unauthorized Error

404

Not Found Error