Surveys & Streams
Get Stream Qualifications
GET
/
v2
/
surveys
/
streams
/
{StreamNumber}
/
qualifications
Get Stream Qualifications
curl --request GET \
--url https://api.researchdesk.com/v2/surveys/streams/{StreamNumber}/qualifications \
--header 'Authorization: <authorization>'import requests
url = "https://api.researchdesk.com/v2/surveys/streams/{StreamNumber}/qualifications"
headers = {"Authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<authorization>'}};
fetch('https://api.researchdesk.com/v2/surveys/streams/{StreamNumber}/qualifications', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.researchdesk.com/v2/surveys/streams/{StreamNumber}/qualifications",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <authorization>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.researchdesk.com/v2/surveys/streams/{StreamNumber}/qualifications"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<authorization>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.researchdesk.com/v2/surveys/streams/{StreamNumber}/qualifications")
.header("Authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.researchdesk.com/v2/surveys/streams/{StreamNumber}/qualifications")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"Status": 0,
"Message": "Success",
"Data": {
"StreamNumber": 850,
"StreamUd": "f1789d2b-ac7c-415b-bcb5-8b285e60e698",
"StreamStatus": "Live",
"Qualifications": [
{
"StandardGlobalQuestionID": 42,
"QualificationsName": "Age",
"Condition": "Is",
"QualificationType": "Numeric - Open End",
"QualificationClass": "Standard",
"PreCodes": [
"18",
"19",
"20",
"21",
"22",
"23",
"24",
"25"
]
},
{
"StandardGlobalQuestionID": 43,
"QualificationsName": "Gender",
"Condition": "Is",
"QualificationType": "Single Punch",
"QualificationClass": "Standard",
"PreCodes": [
"1",
"2"
]
}
]
}
}Returns a Stream’s qualifications — the criteria that define a respondent’s eligibility for the survey.
Path Parameters
| Parameter | Description | Required | Example |
|---|---|---|---|
StreamNumber | The StreamNumber (integer) or StreamUd (UUID) of the stream. | Yes | 850 |
Key Response Fields
| Field | Description |
|---|---|
StandardGlobalQuestionID | Global ID for the qualification question. |
Condition | Logical criteria for the qualification. Values: Is, IsNot, null. |
QualificationType | Question type: Single Punch, Multi Punch, Numeric - Open End, Text - Open End, Derived, Zip Code. |
QualificationClass | Standard (a Lucid Marketplace qualification, used for targeting) or Custom (created by Research Desk Support; use for dynamic profiling or pre-screening). |
PreCodes | Selected pre-codes for the qualification’s answer criteria. |
A change to QualificationsLastChangedTimestamp on the Surveys endpoint signals that you should refresh this Stream’s qualifications.
Headers
Your obfuscated Supply API key (GUID), provided by Rep Data.
Path Parameters
StreamNumber (integer) or StreamUd (UUID).
Was this page helpful?
Get Stream Qualifications
curl --request GET \
--url https://api.researchdesk.com/v2/surveys/streams/{StreamNumber}/qualifications \
--header 'Authorization: <authorization>'import requests
url = "https://api.researchdesk.com/v2/surveys/streams/{StreamNumber}/qualifications"
headers = {"Authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<authorization>'}};
fetch('https://api.researchdesk.com/v2/surveys/streams/{StreamNumber}/qualifications', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.researchdesk.com/v2/surveys/streams/{StreamNumber}/qualifications",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <authorization>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.researchdesk.com/v2/surveys/streams/{StreamNumber}/qualifications"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<authorization>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.researchdesk.com/v2/surveys/streams/{StreamNumber}/qualifications")
.header("Authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.researchdesk.com/v2/surveys/streams/{StreamNumber}/qualifications")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"Status": 0,
"Message": "Success",
"Data": {
"StreamNumber": 850,
"StreamUd": "f1789d2b-ac7c-415b-bcb5-8b285e60e698",
"StreamStatus": "Live",
"Qualifications": [
{
"StandardGlobalQuestionID": 42,
"QualificationsName": "Age",
"Condition": "Is",
"QualificationType": "Numeric - Open End",
"QualificationClass": "Standard",
"PreCodes": [
"18",
"19",
"20",
"21",
"22",
"23",
"24",
"25"
]
},
{
"StandardGlobalQuestionID": 43,
"QualificationsName": "Gender",
"Condition": "Is",
"QualificationType": "Single Punch",
"QualificationClass": "Standard",
"PreCodes": [
"1",
"2"
]
}
]
}
}