Retrieve answers for a question

GET

https://www.rapidoform.com/be/api/response/respondentwise/:questionId/:startDate/:endDate/:page/:size/:bookmark

All requests require X-EMAIL and X-API-KEY. See authentication and errors. JSON request bodies also require Content-Type: application/json. All IDs in examples are synthetic; replace them with your own values.

Parameters

NameType / locationDescription
questionIdpath stringRequired question ObjectId.
startDate, endDatepath stringRequired YYYY-MM-DD dates.
page, sizepath numberRequired positive integers; page is one-based.
bookmarkpath booleanRequired true for answers whose respondent is bookmarked, false for all.
excludeUnansweredquery booleanOptional true restricts answers to questionAttempt: true.
sortByquery stringOptional new for newest first. Any other value (including omitted or old) sorts oldest first.

Returns result and totalQuestionResponse. Answer fields vary by question type, including userResponse and joined question/respondents details.

Example request

curl --request GET 'https://www.rapidoform.com/be/api/response/respondentwise/000000000000000000000001/2026-01-01/2026-12-31/1/10/false' \
  --header "X-EMAIL: $RAPIDOFORM_EMAIL" \
  --header "X-API-KEY: $RAPIDOFORM_API_KEY"

Response

Examples show selected fields, not every stored property. Empty arrays are valid for list/report endpoints.

{
  "Errors": [],
  "Info": [],
  "Data": [
    {
      "result": [],
      "totalQuestionResponse": 0
    }
  ],
  "ErrorCode": "SUCCESS",
  "fieldErrors": {
    "List": []
  }
}

HTTP 200 alone does not indicate success. Check ErrorCode and Errors; see troubleshooting.