GET
/smart-forms/:id/sessions/:sessionIdGet Session
Retrieve the full detail of a single smart form session including Q&A and AI analysis
Scope: SMART_FORMS_READ
Overview
Returns the complete detail of a session, including all questions and answers, AI analysis output, and token usage. The analysis field is null for sessions that have not yet completed their AI analysis job.
Request
GET
/smart-forms/:id/sessions/:sessionIdHeaders
| Header | Value |
|---|---|
Authorization | Bearer fxk_live_<your-api-key> |
Path Parameters
Example Request
curl -X GET "https://api.formfex.com/api/v1/public/smart-forms/SMART_FORM_ID/sessions/SESSION_ID" \
-H "Authorization: Bearer $FORMFEX_API_KEY"Response
Response Fields
| Field | Type | Description |
|---|---|---|
id | string (UUID) | Session identifier |
respondentEmail | string | null | Respondent's email |
respondentFirstName | string | null | Respondent's first name |
respondentLastName | string | null | Respondent's last name |
status | string | ACTIVE, ANALYZING, COMPLETED, or EXPIRED |
completionType | string | null | natural or early_exit |
questionsAnswered | number | Count of answered questions |
maxQuestions | number | Configured maximum questions |
questionsAndAnswers | array | Ordered list of question/answer entries (see below) |
questionsAndAnswers[].questionIndex | number | Zero-based question index |
questionsAndAnswers[].question | string | AI-generated question text |
questionsAndAnswers[].answer | string | null | Respondent's answer. null if the question was not yet answered. |
questionsAndAnswers[].insight | string | null | Per-answer AI insight generated at answer time. null if not yet available. |
questionsAndAnswers[].answeredAt | string | null | ISO 8601 timestamp when the answer was submitted |
analysis | object | null | Full AI analysis result. null until the analysis job completes. |
analysis.summary | string | Narrative summary of the session |
analysis.sentimentScore | number | Sentiment score from −1.0 (negative) to 1.0 (positive) |
analysis.completenessScore | number | Completeness score from 0.0 to 1.0 |
analysis.mainSubject | string | Primary topic of the session |
analysis.keyThemes | string[] | List of recurring themes identified |
analysis.actionableInsights | string[] | Suggested actions derived from the session |
creditsUsed | number | null | Credits consumed by the analysis job. null until analysis completes. |
totalTokensUsed | number | null | Total LLM tokens used across the session |
completedAt | string | null | ISO 8601 timestamp when the session was completed |
createdAt | string (ISO 8601) | Session start timestamp |
Polling for Analysis Completion
If status is ANALYZING, poll this endpoint until status changes to COMPLETED and analysis is no longer null. Typical analysis takes 10–30 seconds.
n8n
In n8n, this operation is available as Get Session under the Smart Form resource in the Formfex node.