Skip to main content

Get Survey Responses

GET/v2/project/{project_key}/survey/{survey_id}/responses

One row per person who answered, newest first, with where they came from.

Query parameters​

ParameterTypeRequiredDescription
limitintegernoRows per page, 1 to 100. Default 50
offsetintegernoRows to skip, for paging
filtersJSON arraynoOnly people who gave all of these answers, up to 5. Each { "question", "is" }: a question number and the answer: a choice answer's id, "yes" / "no", an NPS group ("promoter", "passive", "detractor") or a score. Open-text questions can't be filtered on
start_datestringnoYYYY-MM-DD, in the timezone of the tz header (hours from UTC, default 0)
end_datestringnoYYYY-MM-DD
segmentstringnoA quick segment, as on the experiment report: new, returning, desktop, mobile, direct, referral, social, or country-XX

Example​

curl "https://api-{region}.mida.so/v2/project/YOUR_PROJECT_KEY/survey/42/responses?limit=2" \
  -H "Authorization: Bearer YOUR_GENERATED_API_KEY"

Success response​

{
  "success": true,
  "responses": [
    {
      "answered_at": "2026-10-27 21:08:54",
      "answers": { "1": "Instructor", "3": "Yes" },
      "device": "Mobile",
      "source": "chatgpt.com",
      "country": "DZ",
      "email": ""
    },
    {
      "answered_at": "2026-10-27 13:07:51",
      "answers": { "1": "Student", "2": "No" },
      "device": "Desktop",
      "source": "google.com",
      "country": "US",
      "email": ""
    }
  ],
  "more": true
}
  • answers is keyed by question number. A question the person wasn't asked, or skipped, is left out.
  • source is the utm_source of their landing page, google (ads) or facebook (ads) for an ad click, otherwise the referring site, or Direct.
  • email is filled only when your site identified the visitor with mida.identify. An email typed into an open-text answer shows in answers, not here.
  • more is true when another page follows: call again with offset increased by limit.

Error responses​

StatusMeaning
400A filter that names no question or an answer that question doesn't have, or an unknown segment
401Invalid or missing API key
403Surveys need a paid plan, or the key's user is a Viewer (for changes)
404Project or survey not found. A survey from another project is not found