Panelist

NameDescriptionTypeAdditional information
PreviewUrl

This URL leads to an preview version of the survey.

string

LiveUrl

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

string

MailPreviewUrl

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

string

PanelistStatusId

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

integer

3/lookup/paneliststatus

DateAdded

Date added to the survey

date

DateInvited

Date invitation has been sent

date

DateSawMail

Date the mail has been viewed

date

DateClickedThrough date

DateReminded

Date reminder has been sent

date

DateRemindedPartial

Date partial reminder has been sent

date

DateResponded

Date the panelist responded to the survey

date

Password

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

string

DateSentThankYouMail

Date thank you mail has been sent

date

DateToBeInvited

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

date

ISO 8601 format

DateSecondReminder

Date second reminder has been sent

date

DateToExpire

Date the invitation will expire

date

ISO 8601 format

DateLastModified

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

date

ISO 8601 format

ContactId

Unique contact number.

integer

FirstName

Contact’s first name.

string

Not available when retrieving respondents for an anonymous survey

LastName

Contact’s last name.

string

Not available when retrieving respondents for an anonymous survey

Email

Contact's email address.

string

Not available when retrieving respondents for an anonymous survey

LangCode

2-letter ISO 639-1 language code

string

CustomField1

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

string

CustomField2

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

string

CustomField3

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

string

CustomField4

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

string

CustomField5

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

string

CustomField6

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

string

CustomField7

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

string

CustomField8

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

string

CustomField9

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

string

CustomField10

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

string

CustomField11

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

string

CustomField12

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

string

CustomField13

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

string

CustomField14

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

string

CustomField15

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

string

CustomField16

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

string

CustomField17

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

string

CustomField18

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

string

CustomField19

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

string

CustomField20

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

string

Street

Contact's street name.

string

Not available when retrieving respondents for an anonymous survey

HouseNumber

Contact's house number.

string

Not available when retrieving respondents for an anonymous survey

Suite

Contact's apt. number.

string

Not available when retrieving respondents for an anonymous survey

PostalCode

Postal code.

string

City

Contact's city.

string

State

ISO 3166-2 two-last letters state code.

string

3/lookup/states

Province

Contact's procince.

string

Phone

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

string

Not available when retrieving respondents for an anonymous survey

CountryId

ISO 3166-1 two-letter country code.

string

3/lookup/countries

Gender

Contact's gender.

string

Matching regular expression pattern: ^[m|M|f|F]$

DateOfBirth

Contact's birthday.

date

* ISO 8601 format * Not available when retrieving respondents for an anonymous survey

IsBounced

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

boolean

IsOptedOut

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

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.

Hateoas

Related Methods

Verb Url Description
GET 3/surveys/{SurveyId}/panelists?top={top}&skip={skip}&select={select}&filter={filter}&orderby={orderby}

Retrieve all panelists from a survey which match the passed criteria.

GET 3/surveys/{SurveyId}/panelists/{ContactId}

Retrieve a panelist from a survey by contactid.