Page Comparison

The primary use of this API End Point is to check exclusion. The supplier can check whether a given PSID

is included in the exclusion list or not.

Implementation

Every survey on PureSpectrum will have a "PSIDRef" List. Whether this list is used for Include or Exclude is determined by the response parameter "Incl_excl" present in the GET /Surveys

 or  GET /Surveys/:Survey_id call. The value of Include Exclude will not change for a survey which goes live. 

API Response for GET /surveys/:survey_id/PSIDref

{
	"PSIDRef":[
		"75xxee23-370b-a8ye-e601-e1fzz59284c8"
		"94xx7b3b-4608-01y4-b908-8aezzab971e1"
		"24xx7db6-8507-47y9-9c67-0c6zz6244d98"
	]
}

Include

Include Survey's are sometimes referred to as recontact surveys. Effectively a buyer will define the list of respondents which they are attempting to reach.  When a respondent that is on this list completes the survey, their id will automatically be removed from the PSIDRef list.  As long as the PSID is present on the Ref list, the respondent may take the survey.  PSID's are consistent across suppliers, so it is possible that the respondent may take a survey from one supplier, and be recontacted via a different supplier.

As a supplier, you should be storing the PSID of each respondent you send into PureSpectrum.  We always append the PSID of the respondent on redirect back to you.  

Exclude

If a survey is not defined as an include survey, the PSIDref list will always contain the EXCLUDE list.  This is the default for surveys created on PureSpectrum.  Leveraging the exclude list will allow you the ability to avoid termination due to deduplication.  You may either call the survey's PSIDRef list, and store it, or you may use the optional query string parameter /PSIDref?PSID=%respondent'sPSID%, which will return back a response of 

API Response for PSIDEligible returns a response in either a 0 or 1. A response of 0 means that the PSID is not eligible for exclusion, where as 1 means that it is eligible.

API Response for  "GET /surveys/:survey_id/PSIDEligible?PSID=75xxee23-370b-a8ye-e601-e1fzz59284c8"

{
	"eligible":1 // 1 is eligible, 0 is ineligible 
}

HEADER Parameters

Query String Parameters

Response Parameters    

HTTP Response Codes

Error Messages