# Survey API
Landing: https://developers.vsee.io/api/survey-api  ·  Spec JSON: https://developers.vsee.io/specs/survey_api_openapi.json
Base URL: https://api-ms.vsee.me/api

## GET /surveys/{survey_code}/responses
URL: https://developers.vsee.io/api/survey-api/get/surveys/%7Bsurvey_code%7D/responses
operationId: getSurveyResponses
Auth: User Token — Requires a user access token from login or SSO.

Get survey responses

Retrieve survey responses based on survey code and optional filters

Parameters:
- X-ApiToken (header, string, required) — API token
- survey_code (path, string, required) — Survey code to filter responses. Use 'all' to retrieve all surveys [enum: all, cancel_intake_survey, provider_visit_survey, cancel_call_survey, post_visit_survey]
- from_time (query, integer, optional) — UNIX timestamp for start of search period
- to_time (query, integer, optional) — UNIX timestamp for end of search period
- clinic_codes (query, string, optional) — Comma-separated list of clinic codes to filter
- visit_ids (query, string, optional) — Comma-separated list of visit IDs to filter

Responses:
- 200 — Survey responses retrieved successfully
```json
{
  "data": [
    {
      "id": "62685d75-b290-4e71-9bf6-33e464457b11",
      "survey_code": "cancel_call_survey",
      "clinic_code": "vclinic",
      "visit_id": "22183940",
      "intake_id": "",
      "room_code": "",
      "user_id": "16811538",
      "data": {
        "reason": "test_call",
        "member_id": "21728487",
        "provider_id": "0"
      },
      "created": 1651006837
    }
  ],
  "total_count": 1131
}
```