PureSpectrum
PureSpectrum websiteHelp center
PureSpectrum websiteHelp center
  1. Respondent inclusion / exclusion
  • Back to home
  • API Reference
  • Feasibility
    • Feasibility & Pricing
  • Attributes
    • Get attribute (V3)
    • Get attributes (V3)
  • Surveys
    • Create survey
    • Get similar surveys
    • Create group multi-country surveys
    • Update survey
    • Update survey
    • Update survey status
    • Update offer price
    • Update group multi-country surveys
    • Get survey information
    • Get survey status
    • Get survey performance
    • Get list of all surveys
    • Surveys health status
    • Pacing details
    • Delete survey
  • Qualifications
    • Add qualification
    • Update qualification
    • Get qualification information
    • Get all qualifications
    • Delete qualification
  • Quotas
    • Add quota
    • Update quota
    • Update quota
    • Get quota information
    • Get quota performance
    • Delete quota
  • Survey group exclusions
    • Create exclusion group
    • Update exclusion group
    • Get exclusion group information
    • Delete exclusion group
  • Respondent inclusion / exclusion
    • Add a PSIDref list to a survey
      POST
    • Update a PSIDref for survey
      PATCH
    • Get PSIDref list for survey
      GET
  • Supplier management
    • Create supplier blend
    • Update the list of suppliers for a survey
    • Get list of available suppliers in a locale
    • Get list of available suppliers for a survey
    • Get list of supplier blends
  • Traffic Channels
    • Create traffic channel
    • Get a list of traffic channels
  • Transactions
    • Update status of transaction (V2)
    • Update status of transaction (V3)
    • Register transaction as complete
    • Get transaction status (V3)
    • Get transaction info (V3)
    • Get transactions info for a survey ID (V3)
  • Reconciliation
    • Survey reconciliation
    • Multi survey reconciliation
    • Get status of a reconciliation request
    • Get reconciliation status for an adjustment ID
  • PureText
    • PureText Open-ended (OE) check (V3)
  • Activity logs
    • Get activity logs
    • Get events
  • Templates
    • Get survey templates
  1. Respondent inclusion / exclusion

Add a PSIDref list to a survey

POST
/surveys/{SURVEY_ID}/PSIDref
Last modified:2025-09-16 21:02:19

Description#

Use this endpoint to add a PSIDref list to a survey in order to allow or not allow respondents from previous studies, to access the current survey ID.
More information about recontact /exclusion an be found in the PSID Exclusion / Recontact guide.

Request

Authorization
Add parameter in header
access-token
Example:
access-token: ********************
Path Params

Body Params application/json

Example
[
    { "psid": "75xxee23-370b-a8ye-e601-e1fzz59284c8" },
    { "psid": "94xx7b3b-4608-01y4-b908-8aezzab971e1" },
    { "psid": "24xx7db6-8507-47y9-9c67-0c6zz6244d98" },
    { "psid": "599446a6-6388-4ffe-4c37-9bdc9f6e6edc" },
    { "psid": "685330d0-a8f2-df6f-ae28-7eb89d290277" }
]

Request Code Samples

Shell
JavaScript
Java
Go
PHP
Python
C#
Ruby
Request Request Example
Shell
JavaScript
Java
Go
curl --location --globoff 'https://staging.spectrumsurveys.com/buyers/v2/surveys/{{SURVEY_ID}}/PSIDref' \
--header 'access-token: <api-key>' \
--header 'Content-Type: application/json' \
--data '[
    { "psid": "75xxee23-370b-a8ye-e601-e1fzz59284c8" },
    { "psid": "94xx7b3b-4608-01y4-b908-8aezzab971e1" },
    { "psid": "24xx7db6-8507-47y9-9c67-0c6zz6244d98" },
    { "psid": "599446a6-6388-4ffe-4c37-9bdc9f6e6edc" },
    { "psid": "685330d0-a8f2-df6f-ae28-7eb89d290277" }
]'

Responses

🟢201Created
application/json
Bodyapplication/json

Example
[
    {
        "psid": "75xxee23-370b-a8ye-e601-e1fzz59284c8",
        "link": null
    },
    {
        "psid": "24xx7db6-8507-47y9-9c67-0c6zz6244d98",
        "link": null
    },
    {
        "psid": "685330d0-a8f2-df6f-ae28-7eb89d290277",
        "link": null
    },
    {
        "psid": "94xx7b3b-4608-01y4-b908-8aezzab971e1",
        "link": null
    },
    {
        "psid": "599446a6-6388-4ffe-4c37-9bdc9f6e6edc",
        "link": null
    }
]
🟠400Bad Request
Modified at 2025-09-16 21:02:19
Previous
Respondent inclusion / exclusion
Next
Update a PSIDref for survey