Get Survey Response File
Generate a temporary download URL for a file attached to a specific survey response.
Endpoint
GET
/v5/survey/{survey_id}/surveyresponse/{response_id}/file
Authentication is required for all requests. See Authentication.
Path Parameters
survey_id
integer
required
The ID of the survey that contains the response.
response_id
integer
required
The ID of the survey response that contains the file upload.
Query Parameters
filename
string
required
The filename of the uploaded file to retrieve. This value can be found in the survey response answer data for the file upload question — it is the filename as stored by Alchemer, not the original name provided by the respondent.
expires
integer
The number of seconds until the generated download URL expires. Defaults to
300 (5 minutes).Response
result_ok
boolean
Returns
true if the request was successful.code
integer
HTTP status code for the operation.
message
string
A status message describing the result.
data
object
An object containing the download details.
child attributes
survey_id
string
The ID of the survey.
response_id
string
The ID of the survey response.
filename
string
The filename of the retrieved file.
download_url
string
A temporary pre-signed URL for downloading the file. This URL expires after the number of seconds specified by the
expires parameter (default 300 seconds).Examples
Request
curl -X GET "https://api.alchemer.com/v5/survey/123456/surveyresponse/1/file?filename=uploaded_document.pdf&expires=600&api_token=YOUR_API_TOKEN&api_token_secret=YOUR_API_TOKEN_SECRET"
Response
{
"result_ok": true,
"code": 200,
"message": "Success",
"data": {
"survey_id": "123456",
"response_id": "1",
"filename": "uploaded_document.pdf",
"download_url": "https://storage.alchemer.com/files/uploaded_document.pdf?X-Amz-Expires=600&X-Amz-Signature=abc123..."
}
}