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
| Name | Type / location | Description |
|---|---|---|
| questionId | path string | Required question ObjectId. |
| startDate, endDate | path string | Required YYYY-MM-DD dates. |
| page, size | path number | Required positive integers; page is one-based. |
| bookmark | path boolean | Required true for answers whose respondent is bookmarked, false for all. |
| excludeUnanswered | query boolean | Optional true restricts answers to questionAttempt: true. |
| sortBy | query string | Optional 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.