Respondent

RespondentId

Unique respondent number


Type integer
LanguageCode

2-letter ISO 639-1 language code


Type string
RespondentStatusId

The id shows the completion level: partial, reached end or screened out.


Type integer
Additional info
ResponseDate

Date Responded (in ISO 8601 format)


Type date
Additional info

In case of an anonymous survey the time is reset to 00:00:00

,

Obsolete: This field will be replaced with DateResponded.

CompletionTime

Time (in seconds) spent completing the survey


Type integer
Additional info

Not available for an anonymous survey

DistributionMethodId

The channel used to reach the survey e.g. email, SMS, etc.


Type integer
Additional info
BrowserId

The id of the browser used to complete the survey


Type byte
Additional info
OsId

The id of the operating system used to complete the survey


Type byte
Additional info
IsMobile

Whether or not the respondent was using a mobile operating system to complete the survey


Type boolean
IpAddress

The IP address used to complete the survey


Type string
Additional info

Not available for an anonymous survey

RespondentReportUrl

Url to the respondent’s answer summary webpage


Type string
ReportUrl

Url to the internal respondent's answer summary webpage


Type string
Additional info

The report contains contactinformation and hidden questions.

EditUrl

This URL will allow you to change responses given to this survey.


Type string
Additional info

Be sure you have permission from the respondent and you must respect the ICC/Esomar international code at all times. Learn more

Responses

All responses for this respondent. When retrieving a list of respondents, this property is by default not available. For instance if you are building an overview of respondents, you won't use the responses. If you would like this additional information, you can use the expand parameter expand=Responses.


Type Collection of Response
Additional info
Location

Location based on the IP address. When retrieving a list of respondents, this property is by default not available. If you would like this additional information, you can use the expand parameter expand=Location.


Type IPLocation
Additional info

Expandable, not available for an anonymous survey

Score

The total score for this respondent: sum of all SurveyQuestionResponse.Value


Type decimal number
RespondentHash

The unique hash for this respondent, when using an external url in branching you should include and validate the respondent hash. The external url can be very useful when building custom respondent reports.


Type string
PanelistStatusId

Status of the panelist e.g. included, invited, bounced, etc. Learn more.


Type integer
Additional info

3/lookup/paneliststatus

,

Obsolete: Replaced with ContactStatusId

ContactStatusId

Status of the contact e.g. included, invited, bounced, etc. Learn more.


Type integer
Additional info
DateAdded

Date added to the survey


Type date
Additional info
DateInvited

Date invitation has been sent


Type date
Additional info
DateSawMail

Date the mail has been viewed


Type date
Additional info
DateClickedThrough

Type date
Additional info
DateReminded

Date reminder has been sent


Type date
Additional info
DateRemindedPartial

Date partial reminder has been sent


Type date
Additional info
DateResponded

Date the panelist responded to the survey


Type date
Additional info
Password

The password which respondents need to access the survey. This is only available if the distribution panel "Paper - with panel" is active.


Type string
DateSentThankYouMail

Date thank you mail has been sent


Type date
Additional info
DateToBeInvited

Date invitation will be sent in case it's different then the DateAdded


Type date
Additional info
DateSecondReminder

Date second reminder has been sent


Type date
Additional info
DateToExpire

Date the invitation will expire


Type date
Additional info
DateLastModified

Date and time that the panelist was last modified. This date only relates to the panelist information, not to contact/respondent data.


Type date
Additional info
ContactId

Unique contact number.


Type integer
FirstName

Contact’s first name.


Type string
Additional info

Not available when retrieving respondents for an anonymous survey

LastName

Contact’s last name.


Type string
Additional info

Not available when retrieving respondents for an anonymous survey

Email

Contact's email address.


Type string
Additional info

Not available when retrieving respondents for an anonymous survey

LangCode

2-letter ISO 639-1 language code


Type string
CustomField1

A field which can be used to store additional contact information.


Type string
CustomField2

A field which can be used to store additional contact information.


Type string
CustomField3

A field which can be used to store additional contact information.


Type string
CustomField4

A field which can be used to store additional contact information.


Type string
CustomField5

A field which can be used to store additional contact information.


Type string
CustomField6

A field which can be used to store additional contact information.


Type string
CustomField7

A field which can be used to store additional contact information.


Type string
CustomField8

A field which can be used to store additional contact information.


Type string
CustomField9

A field which can be used to store additional contact information.


Type string
CustomField10

A field which can be used to store additional contact information.


Type string
CustomField11

A field which can be used to store additional contact information.


Type string
CustomField12

A field which can be used to store additional contact information.


Type string
CustomField13

A field which can be used to store additional contact information.


Type string
CustomField14

A field which can be used to store additional contact information.


Type string
CustomField15

A field which can be used to store additional contact information.


Type string
CustomField16

A field which can be used to store additional contact information.


Type string
CustomField17

A field which can be used to store additional contact information.


Type string
CustomField18

A field which can be used to store additional contact information.


Type string
CustomField19

A field which can be used to store additional contact information.


Type string
CustomField20

A field which can be used to store additional contact information.


Type string
Street

Contact's street name.


Type string
Additional info

Not available when retrieving respondents for an anonymous survey

HouseNumber

Contact's house number.


Type string
Additional info

Not available when retrieving respondents for an anonymous survey

Suite

Contact's apt. number.


Type string
Additional info

Not available when retrieving respondents for an anonymous survey

PostalCode

Postal code.


Type string
City

Contact's city.


Type string
State

ISO 3166-2 two-last letters state code.


Type string
Additional info
Province

Contact's procince.


Type string
Phone

Contact's phone number in the E.164 format (+[country code] [area code] [number])


Type string
Additional info

Not available when retrieving respondents for an anonymous survey

CountryId

ISO 3166-1 two-letter country code.


Type string
Additional info
Gender

Contact's gender.


Type string
Additional info
Matching regular expression pattern: ^[m|M|f|F]$
DateOfBirth

Contact's birthday.


Type date
Additional info
IsBounced

Indicates if the email address for this contact is currently on the bounce list.


Type boolean
IsOptedOut

Indicates if this contact is currently on the opt out list.


Type boolean
Links

HATEOAS related to this object. It wil contain relevant url's such as previous and next page for paged results, create/update/delete action. These url's can be used in your application for the next steps in your application logic.


Type Hateoas

Related Methods

Retrieve all respondents from a survey which match the passed criteria. Use the expand=Responses parameter to immediately include the responses of a respondent.

Get the respondent with responses from a survey.

Occurs when a respondent completes a survey.

Occurs for each page a respondent completes.