GET /Surveys/:Survey_id/PSIDEligible - http://api.spectrumsurveys.com/suppliers/v2/Surveys/:Survey_id/PSIDEligible?PSID=%PSID%
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.
Not yet available on Staging or Production.
Implementation
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
Parameter | Type | Required | Description |
|---|---|---|---|
access-token | string | Yes | Token used to identify the authenticity of the user. |
Query String Parameters
Parameter | Type | Required | Description |
|---|---|---|---|
PSID | string | Yes | The respondent's persistent PSID |
Response Parameters
Parameter | Type | Description | Nullable |
|---|---|---|---|
| eligible | number | Shows whether a PSID is eligible for exclusion. Either a 0 or 1. | no |
HTTP Response Codes
Response | Status | Description |
|---|---|---|
200 | OK | |
| 400 | Bad Request | See Error Messages |
| 404 | Not Found | Qualification code doesn't exist in database |
5xx | Internal Server Error | Please Report to support@purespectrum.com |
Error Messages
Response | Description |
|---|---|
1001 | Invalid Survey ID |
| 1002 | Invalid PSID Format |
9999 | Unknown Error - Please Report to support@purespectrum.com |