Get Survey Drop-Off Rates

Retrieve drop-off statistics for a quiz, showing where users abandoned the survey.

---

Overview

This endpoint returns drop-off statistics for a quiz, showing at which questions users abandoned the survey. Only users who started but never completed the quiz are counted.

Method: GET
Endpoint:
/api/v1/namespaces/{namespaceId}/quizzes/{quizId}/dropoffs

Requires administrator authentication with valid token or API key.

---

Request

Headers

x-api-key: {your_api_key}  # Required
Content-Type: application/json

Path Parameters

Parameter	Type	Required	Description
namespaceId	string	✅	The unique identifier for the namespace
quizId	string	✅	The unique identifier for the quiz

---

Response

{
  "fhn1": {
    "questionType": "Multiple Choice",
    "questionText": "How would you rate your overall fina...",
    "dropOffCount": 5,
    "dropOffPercentage": "12.50"
  },
  "fhn2": {
    "questionType": "Multiple Select",
    "questionText": "Which of the following best describes...",
    "dropOffCount": 3,
    "dropOffPercentage": "7.50"
  }
  ...
}

Response Fields

The response is an object where each key is a question ID, containing:

Field	Type	Description
questionType	string	Type of question (Multiple Choice, Multiple Select, etc.)
questionText	string	Question text (truncated to 50 characters with "..." appended if longer)
dropOffCount	number	Number of users who dropped off at this question
dropOffPercentage	string	Percentage of users who dropped off (2 decimal places)

---

Understanding Drop-Off Percentages

The dropOffPercentage for each question represents the proportion of all users who started the quiz that abandoned at that specific question. The sum of all dropOffPercentage values equals the overall incompletion rate for the quiz.

Example: A quiz with 100 respondents where 40 completed and 60 abandoned:

• The overall incompletion rate is 60%
• If 30 users dropped off at question 1 (30%), 20 at question 2 (20%), and 10 at question 3 (10%)
• The sum of all dropOffPercentage values = 30% + 20% + 10% = 60% (the total incompletion rate)

This breakdown helps identify which specific questions are causing the most abandonment.

---

Notes

• Only users who started but did not complete the quiz are included in the statistics.
• Question text is truncated to 50 characters with "..." appended if longer.