PureSpectrum
PureSpectrum websiteHelp center
PureSpectrum websiteHelp center
  1. Attributes
  • Back to home
  • API Reference
  • Feasibility
    • Feasibility & Pricing
  • Attributes
    • Get attribute (V3)
      GET
    • Get attributes (V3)
      GET
  • 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
    • 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. Attributes

Get attributes (V3)

GET
/attributes
Last modified:2026-09-29 12:51:24

Description#

This endpoint is used to retrieve a comprehensive list of Core qualifications and Advanced Targeting questions accessible within a specific locale on the PureSpectrum platform.
Some questions might be present in multiple pages.
So, always look for total_pages in the response header and check all the pages to get the full list of questions.
Multiple classes can be called in a single GET call to retrieve exhaustive list of questions
Example:
/attributes?localization=en_US&class=1,2,3&page=10
Attributes data is different between staging and production. Codes, categories, values could all be different between the two environments.
This endpoint uses version V3 of the Buy API.
Staging: https://staging.spectrumsurveys.com/buyers/v3/attributes
Production: https://api.spectrumsurveys.com/buyers/v3/attributes
Although the V2 version is still operational, its response schema and data are outdated.
Keep your attributes up to date
New qualification codes may be added over time, giving you more ways to target your audience. Call this endpoint regularly, so that your targeting always reflects the latest available options.

Request

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

Request Code Samples

Shell
JavaScript
Java
Go
PHP
Python
C#
Ruby
Request Request Example
Shell
JavaScript
Java
Go
curl --location 'https://staging.spectrumsurveys.com/buyers/v3/attributes?localization=en_US&class=2&page=undefined' \
--header 'access-token: <api-key>'

Responses

🟢200Success
application/json
Headers

Bodyapplication/json

Examples
The number of attributes returned by the API is larger compared to this example, which only shows a small subset for demo purposes.
[
	{
		"qualification_code": 211,
		"recency": 30,
		"desc": "Gender",
		"category": [],
		"tags": "",
		"type": 1,
		"class": 1,
		"create_survey_question_order": 1000,
		"randomize_answer_options": false,
		"is_hidden": false,
		"is_active": true,
		"localizations": [
			{
				"locale": "en_GB",
				"text": "I'm a %%211%%",
				"placeholder": "Male/Female",
				"answers": [
					{
						"answer_id": "111",
						"local_text": "Male",
						"eng_text": "Male",
						"condition_code": 111
					},
					{
						"answer_id": "112",
						"local_text": "Female",
						"eng_text": "Female",
						"condition_code": 112
					},
					{
						"answer_id": "113",
						"local_text": "Prefer not to say",
						"eng_text": "Prefer not to say",
						"condition_code": 113
					}
				],
				"format": {
					"min": null,
					"max": null,
					"regex": ""
				}
			}
		]
	},
	{
		"qualification_code": 213,
		"recency": 30,
		"desc": "Income",
		"category": [],
		"tags": "",
		"type": 5,
		"class": 1,
		"create_survey_question_order": 3000,
		"randomize_answer_options": false,
		"is_hidden": false,
		"is_active": true,
		"localizations": [
			{
				"locale": "en_GB",
				"text": "My household earns approximately £%%213%% per year",
				"placeholder": "123456",
				"answers": [],
				"format": {
					"min": 0,
					"max": 999999,
					"regex": "/^([0-9]{1,6})$/i"
				}
			}
		]
	},
	{
		"qualification_code": 212,
		"recency": 30,
		"desc": "Age",
		"category": [],
		"tags": "",
		"type": 5,
		"class": 1,
		"create_survey_question_order": 2000,
		"randomize_answer_options": false,
		"is_hidden": false,
		"is_active": true,
		"localizations": [
			{
				"locale": "en_GB",
				"text": "I was born in %%234%% %%235%%",
				"placeholder": "",
				"answers": [],
				"format": {
					"min": 13,
					"max": 99,
					"regex": "/^(1[3-9]|([2-9][0-9]))$/i"
				}
			}
		]
	}
]
🟠400Bad Request
🟠401Unauthorized
🟠404Record Not Found
Modified at 2026-09-29 12:51:24
Previous
Get attribute (V3)
Next
Surveys