---
title: "Initial questionnaire response analytics"
method: GET
path: "/api/analytics/registered-patients/questionnaires/initial"
tags: ["analytics"]
---

# Initial questionnaire response analytics

`GET /api/analytics/registered-patients/questionnaires/initial`

Returns respondent and option counts for the completed-questionnaire cohort in mv_registered_patients, filtered by registration period. Stored answers whose keys are not present in the active initial template are ignored.

## Query parameters

- `from_date` string, date, required — Registration period start date (YYYY-MM-DD).
- `to_date` string, date, required — Registration period end date (YYYY-MM-DD).

## Response `200`

Successful Response

- InitialQuestionnaireAnalyticsResponse — Analytics for the current initial questionnaire and registration cohort.
  - `questionnaire_type` string
  - `from_date` string, date, required
  - `to_date` string, date, required
  - `total_respondents` integer, required — Registered patients with at least one answer matching a current question key
  - `questions` QuestionnaireQuestionAnalytics[], required — Current questions; text questions have respondent counts but no inline answers
    - `key` string, required — Key used by the current questionnaire template
    - `text` string, required — Current question text
    - `type` string, required — Question type (multi, radio, text, ...)
    - `respondents` integer, required — Registered patients who answered the question
    - `answers` QuestionnaireAnswerCount[] — Counts for the current configured options
      - `answer` string, required — Current answer label
      - `count` integer, required — Registered patients who selected this answer

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/corabea/apis/corabea-api.md) · [All operations](https://skmtc.dev/corabea/apis/corabea-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/corabea/corabea-api/revisions/13c1bce1bdc4/schema)