Reports Extra
Get additional report data: file uploads, text answers and public links
Additional report data
In addition to standard aggregated metrics, SurveyNinja lets you retrieve extra detail on reports: files uploaded by respondents, and text responses for individual widgets.
These endpoints use the public report UUID and widget identifiers within it. This is convenient if you want to embed a report in your system but occasionally pull "raw" attachments or text responses.
Endpoint overview
| HTTP | Endpoint | Purpose |
|---|---|---|
| GET | /quiz/{id}/report/{report_uuid}/files | Get report widget files (type "file") |
| GET | /quiz/{id}/report/{report_uuid}/inputs | Get text responses for a report widget |
Report widget files
The endpoint GET /quiz/{id}/report/{report_uuid}/files returns the list of files attached to a widget of type file in the report.
The response includes the fields url, name and ext for each file.
Path parameters
id— survey ID.report_uuid— public report UUID.
Query parameters
| Parameter | Type | Description |
|---|---|---|
| widget_id | string | Question UUID (question_uuid of the widget in the report). |
| widget_hash | string | Widget version UUID (widget_hash in shared_report_widgets). |
| limit | integer | Number of records (default 50). |
| offset | integer | Offset (default 0). |
Widget text responses
The endpoint GET /quiz/{id}/report/{report_uuid}/inputs returns text responses for widgets of type input, email, phone, etc.
Query parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
| widget_id | UUID | — | Filter by widget ID |
| widget_hash | UUID | — | Filter by widget version hash |
| limit | integer | 50 | Maximum number of records |
| offset | integer | 0 | Offset for pagination |
curl -X GET "https://api.surveyninja.io/api/v3/service/quiz/123/report/abc-report-uuid/inputs?limit=50&offset=0" \ -H "Authorization: Bearer YOUR_API_TOKEN" \ -H "Accept: application/json"