Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...


Warning

Not yet available on Staging or Production.

Implementation

PSIDEligible returns a response in form of 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"

Code Block
Example 1 :- When the PSID is present in the include List
{
    "apiStatus": "success",
    "msg": "PSID Eligibility Checked successfully",
    "version": "2.0",
    "eligible": 1
}


Example 2 :- When the PSID is *NOT* present in the include List
{
    "apiStatus": "success",
    "msg": "PSID Eligibility Checked successfully",
    "version": "2.0",
    "eligible": 0
}


Example 3 :- When the PSID is present in the Exclude List
{
    "apiStatus": "success",
    "msg": "PSID Eligibility Checked successfully",
    "version": "2.0",
    "eligible": 0
}


Example 4 :- When the PSID is *NOT* present in the Exclude List
{
    "apiStatus": "success",
    "msg": "PSID Eligibility Checked successfully",
    "version": "2.0",
    "eligible": 1
}



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
eligiblenumber

Shows whether a PSID is eligible for exclusion. Either a 0 or 1. 

no

HTTP Response Codes

Response

Status

Description

200

OK


400Bad RequestSee Error Messages
404Not FoundQualification code doesn't exist in database

5xx

Internal Server Error

Please Report to support@purespectrum.com

Error Messages

Response

Description

1001

Invalid Survey ID

1002Invalid PSID Format

9999

Unknown Error - Please Report to support@purespectrum.com


...