Skip to main content
GET
/
qualifications
Qualifications
curl --request GET \
  --url https://demand.researchdesk.com/qualifications \
  --header 'Authorization: <api-key>'
{
  "total_qualifications": 267,
  "page": 1,
  "page_size": 4,
  "qualifications": [
    {
      "id": 1,
      "name": "Age",
      "category": "Demographics",
      "type": "Numeric - Open End",
      "question_text": "What is your age?",
      "question_options": null
    },
    {
      "id": 2,
      "name": "Gender",
      "category": "Demographics",
      "type": "Single Punch",
      "question_text": "What is your gender?",
      "question_options": [
        {
          "id": 1,
          "text": "Male"
        },
        {
          "id": 2,
          "text": "Female"
        }
      ]
    },
    {
      "id": 3,
      "name": "Postal Code/ZIP",
      "category": "Geography",
      "type": "Zip Code",
      "question_text": "What is your zip code?",
      "question_options": null
    },
    {
      "id": 4,
      "name": "Hispanic/Latino Descent",
      "category": "Demographics",
      "type": "Single Punch",
      "question_text": "Are you of Hispanic, Latino, or Spanish origin?",
      "question_options": [
        {
          "id": 1,
          "text": "No , not of Hispanic, Latino, or Spanish origin"
        },
        {
          "id": 2,
          "text": "Yes, Mexican, Mexican American, Chicano"
        },
        {
          "id": 3,
          "text": "Yes, Cuban"
        },
        {
          "id": 16,
          "text": "Yes, Puerto Rican"
        },
        {
          "id": 4,
          "text": "Yes, another Hispanic, Latino, or Spanish origin *** Argentina"
        },
        {
          "id": 5,
          "text": "Yes, another Hispanic, Latino, or Spanish origin *** Colombia"
        },
        {
          "id": 6,
          "text": "Yes, another Hispanic, Latino, or Spanish origin *** Ecuador"
        },
        {
          "id": 7,
          "text": "Yes, another Hispanic, Latino, or Spanish origin *** El Salvadore"
        },
        {
          "id": 8,
          "text": "Yes, another Hispanic, Latino, or Spanish origin *** Guatemala"
        },
        {
          "id": 9,
          "text": "Yes, another Hispanic, Latino, or Spanish origin *** Nicaragua"
        },
        {
          "id": 10,
          "text": "Yes, another Hispanic, Latino, or Spanish origin *** Panama"
        },
        {
          "id": 11,
          "text": "Yes, another Hispanic, Latino, or Spanish origin *** Peru"
        },
        {
          "id": 12,
          "text": "Yes, another Hispanic, Latino, or Spanish origin *** Spain"
        },
        {
          "id": 13,
          "text": "Yes, another Hispanic, Latino, or Spanish origin *** Venezuela"
        },
        {
          "id": 14,
          "text": "Yes, another Hispanic, Latino, or Spanish origin *** Other Country"
        },
        {
          "id": 15,
          "text": "Prefer not to answer"
        }
      ]
    }
  ]
}
Rate limit: 10 requests/second
Query String Parameters
ParameterDescriptionRequiredExample
country_codeThe country code for which the Qualification is available.Yes?country_code=US
language_codeThe language code of the Qualification question text.Yes?language=EN
fieldsComma delimited value of definition keys, dictating the structure of the response.No; if omitted, all parameters will be returned?fields=name,category,type
idsComma delimited value of the qualification IDs being fetchedNo?id=1,2,3
nameURL-encoded value of the qualification name being fetchedNo?name=air%20travel%destinations
categoriesComma delimited value of qualification category options for which associated qualifications will be returned.No?categories=demographics,travel
typesComma delimited value of qualification types for which associated qualifications will be returned.No?types=integer,single punch
pageInteger value of the page being retrievedNo; if omitted, the value defaults to 0?page=2
page_sizeInteger value dictating the number of objects returned per page.No; if omitted, the value defaults to 50?page_size=100

Authorizations

Authorization
string
header
required

Authentication token to be sent directly in the Authorization header (no '' prefix).

Headers

Authorization
string

Query Parameters

country_code
string
language_code
string

Response

200 - application/json

Qualifications

total_qualifications
integer
page
integer
page_size
integer
qualifications
object[]
I