POST api/Surveys/GetSurveyResponseHistory
Provides a list of emails that were sent with tracked surveys and whether the person responded to the survey.
Request Information
URI Parameters
None.
Body Parameters
SurveyResultsRequestModel| Name | Description | Type | Additional information |
|---|---|---|---|
| EmailAddresses |
The email address(es) that you want to get the list of survey responses (you can request up to 10 email addresses in one request) |
Collection of string |
None. |
| LicenseNumber |
Leave this blank (this is used when returning the list of emails to Marquis’ CRM) |
string |
None. |
| StartDate |
(optional) If you do not provide a date, this will default to 90 days in the past |
date |
None. |
| EndDate |
(optional) If you do not provide a date, this will default to the current date and time |
date |
None. |
Request Formats
application/json, text/json
Sample:
{
"EmailAddresses": [
"sample string 1",
"sample string 2"
],
"LicenseNumber": "sample string 1",
"StartDate": "2025-10-23T21:15:18.5915877-06:00",
"EndDate": "2025-10-23T21:15:18.5915877-06:00"
}
application/xml, text/xml
Sample:
<SurveyResultsRequestModel xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<EmailAddresses>
<string>sample string 1</string>
<string>sample string 2</string>
</EmailAddresses>
<LicenseNumber>sample string 1</LicenseNumber>
<StartDate>2025-10-23T21:15:18.5915877-06:00</StartDate>
<EndDate>2025-10-23T21:15:18.5915877-06:00</EndDate>
</SurveyResultsRequestModel>
application/x-www-form-urlencoded
Sample:
Sample not available.
Response Information
Resource Description
SurveyResultsHistory| Name | Description | Type | Additional information |
|---|---|---|---|
| HistoryCount |
Number of records returned |
integer |
None. |
| Result |
Result message |
string |
None. |
| ErrorMessage |
Contains description of any errors that occurred. |
string |
None. |
| History |
List of recipient's survey history |
Collection of SurveyResultsHistoryRecord |
None. |
Response Formats
application/json, text/json
Sample:
{
"HistoryCount": 1,
"Result": "sample string 2",
"ErrorMessage": "sample string 3",
"History": [
{
"EmailAddress": "sample string 1",
"EmailDeliveredDate": "2025-10-23T21:15:18.6072077-06:00",
"CampaignID": "sample string 2",
"MemberGuid": "sample string 3",
"Surveys": null
},
{
"EmailAddress": "sample string 1",
"EmailDeliveredDate": "2025-10-23T21:15:18.6072077-06:00",
"CampaignID": "sample string 2",
"MemberGuid": "sample string 3",
"Surveys": null
}
]
}