PureSpectrum
PureSpectrum websiteHelp center
PureSpectrum websiteHelp center
  1. Qualifications
  • 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
      POST
    • Update qualification
      PUT
    • Get qualification information
      GET
    • Get all qualifications
      GET
    • Delete qualification
      DELETE
  • 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
    • Update a PSIDref for survey
    • Get PSIDref list for survey
  • 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. Qualifications

Add qualification

POST
/surveys/{SURVEY_ID}/qualifications
Last modified:2025-10-05 17:34:47

Description#

Qualifications are criteria used to target specific demographics or characteristics of respondents for surveys.
They are a fundamental aspect of defining the desired audience for a survey and are closely linked with quotas, which specify how many respondents meeting these qualifications are needed.

Key aspects of qualifications#

Core qualifications refer to standard, frequently used demographic or characteristic categories such as gender (qualification code 211) and age (qualification code 212). PureSpectrum provides a full list of Core Qualifications and Condition codes by using the Get attributes endpoint.
Within a qualification, more specific attributes are defined by condition_code. For example, within the gender qualification (211), 111 represents male and 112 represents female.
For qualifications that involve numerical ranges, such as age or income (qualification code 213), range_set are used to define the acceptable values, including a "from" value, a "to" value, and "units" (e.g., 311 for age in years, 321 for income in USD).
The Attributes endpoint can be used to explore the various question types (including core and extended qualifications) accessible within the PureSpectrum marketplace for a specific locale. This API provides details such as the question text, condition codes, and their texts.
Some qualification codes are dependent on other qualification codes (example: 2814 and 2674) and both should be added for the endpoint to work.
Example of error when this is not fulfilled:
{
  "ps_api_response_code": 1007,
  "ps_api_response_message": "2814 is dependent on qualification id 2674, condition codes: 130. Please add and try again"
}

Request

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

Body Params application/json

Examples
{
    "qualification_code": 211,
    "condition_codes": [
        "111",
        "112"
    ]
}

Request Code Samples

Shell
JavaScript
Java
Go
PHP
Python
C#
Ruby
Request Request Example
Shell
JavaScript
Java
Go
cURL
curl --location 'https://staging.spectrumsurveys.com/buyers/v2/surveys/1234567/qualifications' \
--header 'access-token: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "qualification_code": 211,
    "condition_codes": [
        "111",
        "112"
    ]
}'

Responses

🟢201Created
application/json
Bodyapplication/json

Example
{
    "qualification_code": 211,
    "condition_codes": [
        "111",
        "112"
    ]
}
🟠400Bad Request
Modified at 2025-10-05 17:34:47
Previous
Qualifications
Next
Update qualification