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-03-05 20:10:47

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.

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-03-05 20:10:47
Previous
Get attribute (V3)
Next
Surveys