GET /Surveys/:Survey_id/PSIDEligible?PSID=%PSID%&rd_device_id=[%%research_defender_respondent_ud%%]&ip_address=[%%ipv4_address%%]
The primary use of this API End Point is to check the PSID exclusion. The supplier can check whether a given PSID is present in the exclusion list or not.
...
Utilizing this feature will reduce the status "ps_df_dupe" - code 70
Respondent IP Addrress
By passing in a respondent's ip_address value, we are able to prequalify eligibility with some external partners.
Utilizing this feature will reduce the status "buyer_eligibility_precheck" - code 74
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 |
| rd_device_id | string | No | Will check a respondent using Research Defender's /predupe api. Use this to reduce ps_df_dupe statuses |
| ip_address | string | No | Will check a respondent's eligibility with some buyers. IP Address should be in the format 0.0.0.0 |
Response Parameters
Parameter | Type | Description | Nullable |
|---|---|---|---|
| eligible | number | Shows whether a PSID is eligible for inclusion / 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 |
...