> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://dev.neurologyca.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://dev.neurologyca.com/_mcp/server. # Get Video Analysis GET https://softskills-api-b1f382ab39be.herokuapp.com/api/v1/full-analysis/{session_id} Fetch the saved video analysis for a session. Responses may be in-flight, complete, or failed. Reference: https://dev.neurologyca.com/soft-skills/api-reference/get-full-analysis-status ## Authentication - `Authorization` header (bearer token, required) — Your API key (e.g. ng\_xxx...). The Try it and generated code send it as `Authorization: Bearer `. Alternatively use the X-API-Key header with the raw key. - `X-API-Key` header (required) — Alternative authentication header. Send the raw API key as `X-API-Key: `. ## Servers - `https://softskills-api-b1f382ab39be.herokuapp.com` (Softskills API, default) - `http://127.0.0.1:8000` (Local development API) ## Request ### Path parameters - `session_id` (string, required) — Session identifier returned by the full-analysis pipeline. ## Response ### 200 Current saved analysis state for the session. - `status` (enum, required) - Allowed values: `pending`, `processing`, `complete`, `failed` - `sessionId` (string, required) - `userId` (string, required) - `createdAt` (datetime, required) - `updatedAt` (datetime, required) - `jobId` (string, required, nullable) - `progress` (FullAnalysisProgress, required, nullable) - `result` (FullAnalysisResult, required, nullable) - `error` (string, required, nullable) ## Errors ### 401 Unauthorized Error Missing or invalid API key. - `detail` (string, optional) ### 404 Not Found Error Job not found or expired. - `detail` (string, optional) ### 500 Internal Server Error Internal pipeline error. - `detail` (string, optional) ## Types ### FullAnalysisProgress - `phase` (enum, required) - Allowed values: `gemini`, `transcribe`, `frames`, `kpn_upload`, `polling`, `enrich` - `kpnPackagesSent` (integer, required) - `kpnPackagesTotal` (integer, required, nullable) - `enginePolls` (integer, required) ### FullAnalysisResult - `video_analysis` (VideoAnalysis, required) - `biometric_analysis` (BiometricAnalysis, required) - `transcript` (string, required, nullable) ### VideoAnalysis - `overall_score` (double, required) - `category_scores` (map from string to double, required) - `strengths` (list of string, required) - `areas_for_improvement` (list of string, required) - `filler_word_count` (integer, required) - `speaking_pace_wpm` (double, required) - `labeled_moments` (list of VideoAnalysisLabeledMomentsItems, required) - `time_series_scores` (list of VideoAnalysisTimeSeriesScoresItems, required) - `detailed_feedback` (string, required) - `session_summary` (string, required) - `recommendation` (string, required) ### BiometricAnalysis - `classification` (string, optional) - `coherence_level` (string, optional) - `cognitive_effort_level` (string, optional) - `emotion` (string, optional) - `emotion_valence` (double, optional) - `emotion_intensity` (double, optional) - `emotion_quadrant` (integer, optional) - `cognitive_summary` (string, optional) - `emotional_summary` (string, optional) - `behavioral_summary` (string, optional) - `adaptive_context` (string, optional) - `governance_rationale` (string, optional) - `governance_confidence` (double, optional) - `recommended_actions` (list of string, optional) - `action_flags` (map from string to boolean, optional) - `hci_priorities` (map from string to double, optional) - `scientific_context` (string, optional) - `model_version` (string, optional) - `latency_ms` (double, optional) ### VideoAnalysisLabeledMomentsItems - `timestamp` (string, optional) - `label` (string, optional) - `text` (string, optional) ### VideoAnalysisTimeSeriesScoresItems - `timestamp` (string, optional) - `likeability` (double, optional) - `authenticity` (double, optional) - `clarity` (double, optional) - `confidence` (double, optional) ## Examples **Response** ```json { "status": "pending", "sessionId": "string", "userId": "string", "createdAt": "2024-01-15T09:30:00Z", "updatedAt": "2024-01-15T09:30:00Z", "jobId": "string", "progress": { "phase": "gemini", "kpnPackagesSent": 1, "kpnPackagesTotal": 1, "enginePolls": 1 }, "result": { "video_analysis": { "overall_score": 1.1, "category_scores": {}, "strengths": [ "string" ], "areas_for_improvement": [ "string" ], "filler_word_count": 1, "speaking_pace_wpm": 1.1, "labeled_moments": [ { "timestamp": "string", "label": "string", "text": "string" } ], "time_series_scores": [ { "timestamp": "string", "likeability": 1.1, "authenticity": 1.1, "clarity": 1.1, "confidence": 1.1 } ], "detailed_feedback": "string", "session_summary": "string", "recommendation": "string" }, "biometric_analysis": { "classification": "string", "coherence_level": "string", "cognitive_effort_level": "string", "emotion": "string", "emotion_valence": 1.1, "emotion_intensity": 1.1, "emotion_quadrant": 1, "cognitive_summary": "string", "emotional_summary": "string", "behavioral_summary": "string", "adaptive_context": "string", "governance_rationale": "string", "governance_confidence": 1.1, "recommended_actions": [ "string" ], "action_flags": {}, "hci_priorities": {}, "scientific_context": "string", "model_version": "string", "latency_ms": 1.1 }, "transcript": "string" }, "error": "string" } ``` **SDK Code** ```python import requests url = "https://softskills-api-b1f382ab39be.herokuapp.com/api/v1/full-analysis/session_id" headers = {"Authorization": "Bearer "} response = requests.get(url, headers=headers) print(response.json()) ``` ```javascript const url = 'https://softskills-api-b1f382ab39be.herokuapp.com/api/v1/full-analysis/session_id'; const options = {method: 'GET', headers: {Authorization: 'Bearer '}}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "net/http" "io" ) func main() { url := "https://softskills-api-b1f382ab39be.herokuapp.com/api/v1/full-analysis/session_id" req, _ := http.NewRequest("GET", url, nil) req.Header.Add("Authorization", "Bearer ") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://softskills-api-b1f382ab39be.herokuapp.com/api/v1/full-analysis/session_id") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["Authorization"] = 'Bearer ' response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("https://softskills-api-b1f382ab39be.herokuapp.com/api/v1/full-analysis/session_id") .header("Authorization", "Bearer ") .asString(); ``` ```php request('GET', 'https://softskills-api-b1f382ab39be.herokuapp.com/api/v1/full-analysis/session_id', [ 'headers' => [ 'Authorization' => 'Bearer ', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://softskills-api-b1f382ab39be.herokuapp.com/api/v1/full-analysis/session_id"); var request = new RestRequest(Method.GET); request.AddHeader("Authorization", "Bearer "); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = ["Authorization": "Bearer "] let request = NSMutableURLRequest(url: NSURL(string: "https://softskills-api-b1f382ab39be.herokuapp.com/api/v1/full-analysis/session_id")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "GET" request.allHTTPHeaderFields = headers let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```