Qualification and Condition Codes

Qualification and Condition Codes

Our updated BUY API documentation is available here.
We hope you enjoy the new experience! Reach out to us with your feedback or questions on supportbuyapi@purespectrum.com
Happy programming! 🎉

 

You may now utilize the Buy API to retrieve PureSpectrum qualification and condition codes by localization code & question class.

Attributes API

https://api.spectrumsurveys.com/buyers/v3/Attributes?localization=[%%localization%%]&class=[%%class%%]&page=[%%page%%]&format=true

Header Parameters

Parameter

Type

Required

Description

Parameter

Type

Required

Description

access-token

string

Yes

Token used to identify the authenticity of the user.

 

Query String Parameters

Parameter

Type

 Required

Description

Parameter

Type

 Required

Description

localization

string

Yes

This is the country/language combination of the respondent.  Please refer to the table here: Codes & Units

class

integer - options:

1-Core Library

2-Extended Library

3-Custom Library

If this parameter is omitted, all classes are returned.

Questions in the PureSpectrum library are broken into 3 categories:

  • Core: Should be mapped for all suppliers

  • Extended: Frequently used advanced targeting questions that may be mapped by suppliers

  • Custom: Buyer Specific questions that are unlikely to be mapped by suppliers

page

integer

Yes - if more than one page is returned in the response, you must use this to access the additional attributes.

Page information will be returned in the Response Header parameter "total_pages"

 

Quick Reference

Qualification

Qualification Code

Condition Label (Generic)

Conditions Code

en_US

en_US Label

(Same as generic)

en_US Sort Order

en_CA

en_CA Label

(Same as generic)

en_CA Sort Order

en_GB

en_GB Label

(Same as generic)

en_GB

Sort Order

en_AU

en_AU Label

(Same as generic)

en_AU

Sort Order

Qualification

Qualification Code

Condition Label (Generic)

Conditions Code

en_US

en_US Label

(Same as generic)

en_US Sort Order

en_CA

en_CA Label

(Same as generic)

en_CA Sort Order

en_GB

en_GB Label

(Same as generic)

en_GB

Sort Order

en_AU

en_AU Label

(Same as generic)

en_AU

Sort Order

gender

211

 

 

y

 

 

y

 

 

y

 

 

y

 

 

 

 

Male

111

y

y

 

y

y

1

y

y

1

y

y

1

 

 

Female

112

y

y

 

y

y

2

y

y

2

y

y

2

 

 

Prefer not to say

113

Doc Link

 

 

 

 

 

 

 

 

 

 

 

age

212

Age

 

y

 

 

y

Age

 

y

Age

 

y

Age

 

houseHoldIncome

213

Income

 

y

 

 

y

Income

 

y

Income

 

y

Income

 

race

214

 

 

y

 

 

y

Race

 

 

 

 

 

 

 

 

 

White

111

y

 

 

y

White

1

 

 

 

 

 

 

 

 

Hispanic

112

y

 

 

 

 

 

 

 

 

 

 

 

 

 

African American

113

y

 

 

y

Black

2

 

 

 

 

 

 

 

 

Asian

114

y

 

 

y

Asian

3

 

 

 

 

 

 

 

 

American Indian

115

y

 

 

 

 

 

 

 

 

 

 

 

 

 

Middle Eastern

116

y

 

 

 

 

 

 

 

 

 

 

 

 

 

Other ethnicity

117

y

 

 

y

Other

6

 

 

 

 

 

 

 

 

Native American, Inuit or Aleut

118

 

 

 

y

Native American, Inuit or Aleut

4

 

 

 

 

 

 

 

 

Native Hawaiian / Pacific Islander

119

 

 

 

y

Pacific Islander

5

 

 

 

 

 

 

 

 

Prefer not to answer

120

 

 

 

 

 

 

 

 

 

 

 

 

Race/Ethnicity

244

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

White

111

y

 

 

y

 

 

 

 

 

 

 

 

 

 

Black or African American

112

y

 

 

y

 

 

 

 

 

 

 

 

 

 

Asian

113

y

 

 

y