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
NameDescriptionTypeAdditional 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
NameDescriptionTypeAdditional 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
    }
  ]
}