SurveyContact

PreviewUrl

This URL leads to an preview version of the survey.


Type string
LiveUrl

This is the LIVE personal URL for this panelist. All results will be recorded.


Type string
MailPreviewUrl

This is the personal URL for a preview of the mail for this panelist.


Type string
OptoutSourceId

Origin of the optout.


Type byte
Additional info
ReportUrl

This is the personal URL for a report of this contact.


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 contacts from a survey which match the passed criteria.

Retrieve a contact from a survey by contactId.