/
Qualification and Condition Codes

Qualification and Condition Codes

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

 

 

 

 

 

 

 

 

 

 

Native Hawaiian or Other Pacific Islander

114

y

 

 

y

 

 

 

 

 

 

 

 

 

 

American Indian or Alaska Native

115

y

 

 

y

 

 

 

 

 

 

 

 

 

 

Other Race

116

y

 

 

y

 

 

 

 

 

 

 

 

Hispanic Origin

245

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Yes

111

 

 

 

y

 

 

 

 

 

 

 

 

 

 

No

112

 

 

 

y

 

 

 

 

 

 

 

 

employments

215

 

 

y

 

 

y

 

 

y

 

 

y

 

 

 

 

Unemployed

111

y

y

1

y

y

1

y

y

1

y

Unemployed

1

 

 

Student

112

y

y

2

y

y

2

y

y

2

y

Student

2

 

 

Part Time

113

y

y

3

y

y

3

y

y

3

y

Part Time

3

 

 

Full Time

114

y

y

4

y

y

4

y

y

4

y

Full Time

4

 

 

Retired

115

y

y

5

y

y

5

y

y

5

y

Retired

5

 

 

Contract, Freelance or Temporary Employee

116

 

 

 

y

y

6

 

 

 

 

 

 

 

 

Prefer not to answer

117

 

 

 

y

y

7

 

 

 

 

 

 

educations

216

 

 

y

 

 

y

 

 

 

 

 

 

 

 

 

 

Some high school

111

y

y

1

y

y

1

 

 

 

 

 

 

 

 

High School Graduate

112

y

y

2

y

y

2

 

 

 

 

 

 

 

 

Some College

113

y

y

3

y

y

3

 

 

 

 

 

 

 

 

Bachelor's Degree

114

y

y

4

y

y

4

 

 

 

 

 

 

 

 

Master's Degree

115

y

y

5

y

y

5

 

 

 

 

 

 

 

 

Some Postgraduate

117

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Graduate/Post Graduate Degree

118

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Doctorate Degree

116

y

y

6

y

y

6

 

 

 

 

 

 

 

 

Prefer not to answer

119

 

 

 

 

 

 

 

 

 

 

 

 

relationships

217

 

 

y

 

 

 

 

 

 

 

 

 

 

 

 

 

Single

111

y

y

1

y

y

1

 

 

 

 

 

 

 

 

Engaged

112

y

y

2

y

y

2

 

 

 

 

 

 

 

 

Living with a Partner

113

y

y

3

y

y

3

 

 

 

 

 

 

 

 

Married

114

y

y

4

y

y

4

 

 

 

 

 

 

 

 

Divorced

115

y

y

5

y

y

5

 

 

 

 

 

 

 

 

Widowed

116

y

y

6

y

y

6

 

 

 

 

 

 

 

 

Prefer not to answer

117

 

 

 

y

y

7

 

 

 

 

 

 

device

219

 

 

y

 

 

y

 

 

 

 

 

y

 

 

 

 

Desktop

111

y

 

 

y

Desktop

1

y

Desktop

1

y

Desktop

1

 

 

Mobile

112

y

 

 

y

Mobile

2

y

Mobile

2

y

Mobile

2

 

 

Tablet

113

y

 

 

y

Tablet

3

y

Tablet

3

y

Tablet

3

Location-Nationally Representative

222

 

 

y

 

 

 

 

 

 

 

 

 

 

 

regions

223

 

 

y

 

 

 

 

 

 

 

 

 

 

 

 

 

Northeast

1

y

 

 

 

 

 

 

 

 

 

 

 

 

 

Midwest

2

y

 

 

 

 

 

 

 

 

 

 

 

 

 

South

3

y

 

 

 

 

 

 

 

 

 

 

 

 

 

West

4

y

 

 

 

 

 

 

 

 

 

 

 

divisions

224

 

 

y

 

 

 

 

 

 

 

 

 

 

 

 

 

New England

1

y

 

 

 

 

 

 

 

 

 

 

 

 

 

Middle Atlantic

2

y

 

 

 

 

 

 

 

 

 

 

 

 

 

East North Central

3

y

 

 

 

 

 

 

 

 

 

 

 

 

 

West North Central

4

y

 

 

 

 

 

 

 

 

 

 

 

 

 

South Atlantic

5

y

 

 

 

 

 

 

 

 

 

 

 

 

 

East South Central

6

y

 

 

 

 

 

 

 

 

 

 

 

 

 

West South Central

7

y

 

 

 

 

 

 

 

 

 

 

 

 

 

Mountain

8

y

 

 

 

 

 

 

 

 

 

 

 

 

 

Pacific

9

y

 

 

 

 

 

 

 

 

 

 

 

states

225

 

 

y

 

 

 

 

 

 

 

 

 

 

 

 

 

Use spreadsheet for name and codes

 

 

y

 

 

 

 

 

 

 

 

 

 

 

msa

226

 

 

y

 

 

 

 

 

 

 

 

 

 

 

 

 

Use spreadsheet for name and codes

 

 

y

 

 

 

 

 

 

 

 

 

 

 

csa

227

 

 

y

 

 

 

 

 

 

 

 

 

 

 

 

 

Use spreadsheet for name and codes

 

 

y

 

 

 

 

 

 

 

 

 

 

 

county

228

 

 

y

 

 

 

 

 

 

 

 

 

 

 

 

 

Use spreadsheet for name and codes

 

 

y

 

 

 

 

 

 

 

 

 

 

 

zipcodes

229

 

 

y

 

 

 

 

 

 

 

 

 

 

 

 

 

Use real zipcodes

 

y

 

 

 

 

 

 

 

 

 

 

 

dma

231

Use spreadsheet for name and codes

 

 

y

 

 

 

 

 

 

 

 

 

 

 

child age and gender

NOTE: Legacy Child Age & Gender (Qual 218, 220, 230) will only be available through Q2 2025

232

Use spreadsheet for name and codes - attached below

 

 

y

 

 

y

 

 

y

 

 

y

 

 

provinces

233

 

 

 

 

 

y

 

 

 

 

 

 

 

 

 

 

Alberta

1

 

 

 

y

 

 

 

 

 

 

 

 

 

 

British Columbia

2

 

 

 

y

 

 

 

 

 

 

 

 

 

 

Manitoba

3

 

 

 

y

 

 

 

 

 

 

 

 

 

 

New Brunswick

4

 

 

 

y

 

 

 

 

 

 

 

 

 

 

Newfoundland and Labrador

5

 

 

 

y

 

 

 

 

 

 

 

 

 

 

Nova Scotia

7

 

 

 

y

 

 

 

 

 

 

 

 

 

 

Northwest Territory

6

 

 

 

y

 

 

 

 

 

 

 

 

 

 

Ontario

9

 

 

 

y

 

 

 

 

 

 

 

 

 

 

Prince Edward Island

10

 

 

 

y

 

 

 

 

 

 

 

 

 

 

Quebec

11

 

 

 

y

 

 

 

 

 

 

 

 

 

 

Saskatchewan

12

 

 

 

y

 

 

 

 

 

 

 

 

 

 

Yukon

13

 

 

 

y

 

 

 

 

 

 

 

 

 

US, Location tables attached:

UK, Australia Location tables attached: English_Expansion_Core_Datav4.xlsx

 

Related content

Looking Up Attributes
Looking Up Attributes
More like this
Core Qualification and Condition codes (Full List)
Core Qualification and Condition codes (Full List)
Read with this
Get Attributes By Qualification Code
Get Attributes By Qualification Code
More like this
Codes & Units
Read with this
Create Attributes
Create Attributes
More like this
Request and Response parameters
Request and Response parameters
Read with this