Survey with Multi-Quota Nested
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! 🎉
This is a how-to guide to create, and update Multi-Nested Quotas using Buyer API.
Suppose, for the sake of simplicity, we have these qualifications in the survey -
Gender (211) - Male (111), Female (112)
Device (219) - Desktop (111), Mobile (112)
Hispanic Origin (245) - Yes (111), No (112)
Multi-Nested Quotas Creation
Case - 1
Suppose, we want to create three Nesting Groups with these configurations -
Male - Yes and Male - No Nested Quotas in the Male Group Nesting Group
Female - Yes and Female - No Nested Quotas in the Female Group Nesting Group
Desktop - Yes and Mobile - No Nested Quotas in the Device-Hispanic Group Nesting Group
Request -
Request URL:
POST <BASE_URL>/buyers/v2/surveys
headers - access-token: <BUYER_ACCESS_TOKEN>Request Body:
{
"expected_ir": 50,
"expected_loi": 5,
"live_url": "https://take-stage.purespectrum.com/mp_redirection",
"survey_title": "Multi-Nested Quota survey",
"survey_category_code": 231,
"completes_required": 100,
"offer_price": 8.00,
"field_time": 20,
"survey_localization": "en_US",
"quotas": [
{
"buyer_quota_id": "male-yes",
"required_count": 30,
"criteria": [
{
"qualification_code": 211,
"condition_codes": [
"111"
]
},
{
"qualification_code": 245,
"condition_codes": [
"111"
]
}
],
"group_key": "Male Group"
},
{
"buyer_quota_id": "male-no",
"required_count": 40,
"criteria": [
{
"qualification_code": 211,
"condition_codes": [
"111"
]
},
{
"qualification_code": 245,
"condition_codes": [
"112"
]
}
],
"group_key": "Male Group"
},
{
"buyer_quota_id": "female-yes",
"required_count": 50,
"criteria": [
{
"qualification_code": 211,
"condition_codes": [
"112"
]
},
{
"qualification_code": 245,
"condition_codes": [
"111"
]
}
],
"group_key": "Female Group"
},
{
"buyer_quota_id": "female-no",
"required_count": 50,
"criteria": [
{
"qualification_code": 211,
"condition_codes": [
"112"
]
},
{
"qualification_code": 245,
"condition_codes": [
"112"
]
}
],
"group_key": "Female Group"
},
{
"buyer_quota_id": "desktop-yes",
"required_count": 70,
"criteria": [
{
"qualification_code": 219,
"condition_codes": [
"111"
]
},
{
"qualification_code": 245,
"condition_codes": [
"111"
]
}
],
"group_key": "Device-Hispanic Group"
},
{
"buyer_quota_id": "mobile-no",
"required_count": 30,
"criteria": [
{
"qualification_code": 219,
"condition_codes": [
"112"
]
},
{
"qualification_code": 245,
"condition_codes": [
"112"
]
}
],
"group_key": "Device-Hispanic Group"
}
],
"qualifications": [
{
"qualification_code": 211,
"condition_codes": [
"111",
"112",
"113"
]
},
{
"qualification_code": 245,
"condition_codes": [
"111",
"112"
]
},
{
"qualification_code": 219,
"condition_codes": [
"111",
"112"
]
}
]
}Response -
Response Code:
CODE: 200 OK
Response Body:
{
"aida": {
"enabled": false,
"selected_quota_ids": []
},
"qbp": {
"enable": false
},
"qlc": {
"enable": false,
"multiple_quotas": {
"enable": false,
"count_by_quota": false,
"compensate_by_quota": false
}
},
"soft_launch": {
"enable": false
},
"unique_links": {
"enable": false
},
"click_balancing": 0,
"estimated_clicks": 0,
"survey_external_id": "",
"ps_survey_status": 11,
"offer_price": 8,
"incl_excl": 0,
"quota_throttling": false,
"url_transform": false,
"subscriber_emails": [],
"survey_title": "Multi-Nested Quota survey",
"survey_category_code": 231,
"completes_required": 100,
"field_time": 20,
"buyer_message": null,
"is_modular_survey": false,
"live_url": "https://take-stage.purespectrum.com/mp_redirection",
"billing_id": "PS1181478",
"test_url": null,
"expected_loi": 5,
"expected_ir": 50,
"ps_survey_id": 1181478,
"buyer_surveygroup_ref": null,
"buyer_surveygroup_refs": [],
"test_ps_survey_entry_link": "https://qa3-api.spectrumsurveys.com/#/start-survey?survey_id=1181478&ps_redirect_test=1&bsec=a70mx8&supplier_id=23",
"survey_localization": "en_US",
"uniqueLinks": false,
"quotas": [
{
"buyer_quota_id": "male-yes",
"quota_title": "",
"ps_quota_id": "0c721c3b-dce1-46b2-ba93-2eaa853ab801",
"required_count": 30,
"criteria": [
{
"qualification_code": 211,
"condition_codes": [
"111"
]
},
{
"qualification_code": 245,
"condition_codes": [
"111"
]
}
],
"group_key": "Male Group"
},
{
"buyer_quota_id": "male-no",
"quota_title": "",
"ps_quota_id": "b56fcdef-c210-4b71-9f18-0d9b6842272e",
"required_count": 40,
"criteria": [
{
"qualification_code": 211,
"condition_codes": [
"111"
]
},
{
"qualification_code": 245,
"condition_codes": [
"112"
]
}
],
"group_key": "Male Group"
},
{
"buyer_quota_id": "female-yes",
"quota_title": "",
"ps_quota_id": "dc530f26-05e8-4a7b-8d39-ae0d6d9a156e",
"required_count": 50,
"criteria": [
{
"qualification_code": 211,
"condition_codes": [
"112"
]
},
{
"qualification_code": 245,
"condition_codes": [
"111"
]
}
],
"group_key": "Female Group"
},
{
"buyer_quota_id": "female-no",
"quota_title": "",
"ps_quota_id": "c65e3cd5-fd45-4c05-9ba4-6e5500f6f4ea",
"required_count": 50,
"criteria": [
{
"qualification_code": 211,
"condition_codes": [
"112"
]
},
{
"qualification_code": 245,
"condition_codes": [
"112"
]
}
],
"group_key": "Female Group"
},
{
"buyer_quota_id": "desktop-yes",
"quota_title": "",
"ps_quota_id": "c952530a-19c2-4df0-b7ac-a32755bf1c39",
"required_count": 70,
"criteria": [
{
"qualification_code": 219,
"condition_codes": [
"111"
]
},
{
"qualification_code": 245,
"condition_codes": [
"111"
]
}
],
"group_key": "Device-Hispanic Group"
},
{
"buyer_quota_id": "mobile-no",
"quota_title": "",
"ps_quota_id": "227fbcfb-5a4c-4fb2-97ea-b63dc472b637",
"required_count": 30,
"criteria": [
{
"qualification_code": 219,
"condition_codes": [
"112"
]
},
{
"qualification_code": 245,
"condition_codes": [
"112"
]
}
],
"group_key": "Device-Hispanic Group"
}
],
"qualifications": [
{
"condition_codes": [
"111",
"112",
"113"
],
"qualification_code": 211
},
{
"condition_codes": [
"111",
"112"
],
"qualification_code": 219
},
{
"condition_codes": [
"111",
"112"
],
"qualification_code": 245
}
],
"is_feot_enabled": false,
"feot": {},
"survey_grouping": [],
"blend_id": null,
"schedule_launch": {
"enable": false,
"info": {
"date": null,
"hours": null,
"minutes": null,
"timezone": null,
"dateTimeInISO": null
}
},
"price_reco": false,
"project_creation_date": "2025-05-29T15:28:15.255Z",
"project_last_complete_date": null,
"is_dq_enable": false,
"mc_count": 0,
"tc_count": 0,
"basic_token": {
"enable": false,
"value": null
},
"is_pure_price_rate_card_enable": true,
"dq_settings": {
"purescore_filter_enabled": true,
"fp_device_check": true,
"fp_fraud_check": true
},
"product": "",
"pds_ignore_override": false,
"supplier_allocation_throttle": true,
"blend_applied": false
}Case - 2
Suppose, we want to create a single Nesting Group with more than 4 selections configurations via API (From UI it is not possible as of now).
Request -
Request URL:
POST <BASE_URL>/buyers/v2/surveys
headers - access-token: <BUYER_ACCESS_TOKEN>Request Body:
{
"expected_ir": 50,
"expected_loi": 5,
"live_url": "https://take-stage.purespectrum.com/mp_redirection",
"survey_title": "Multi-Nested Quota survey",
"survey_category_code": 231,
"completes_required": 100,
"offer_price": 8.00,
"field_time": 20,
"survey_localization": "en_US",
"quotas": [
{
"buyer_quota_id": "b1",
"required_count": 30,
"criteria": [
{
"qualification_code": 211,
"condition_codes": [
"111"
]
},
{
"qualification_code": 215,
"condition_codes": [
"111"
]
},
{
"qualification_code": 216,
"condition_codes": [
"111"
]
},
{
"qualification_code": 219,
"condition_codes": [
"111"
]
},
{
"qualification_code": 245,
"condition_codes": [
"111"
]
},
{
"qualification_code": 1032,
"condition_codes": [
"111"
]
}
],
"group_key": "Gender-Hispanic Group"
},
{
"buyer_quota_id": "b2",
"required_count": 30,
"criteria": [
{
"qualification_code": 211,
"condition_codes": [
"112"
]
},
{
"qualification_code": 215,
"condition_codes": [
"111"
]
},
{
"qualification_code": 216,
"condition_codes": [
"111"
]
},
{
"qualification_code": 219,
"condition_codes": [
"111"
]
},
{
"qualification_code": 245,
"condition_codes": [
"111"
]
},
{
"qualification_code": 1032,
"condition_codes": [
"111"
]
}
],
"group_key": "Gender-Hispanic Group"
},
{
"buyer_quota_id": "b3",
"required_count": 40,
"criteria": [
{
"qualification_code": 211,
"condition_codes": [
"112"
]
},
{
"qualification_code": 215,
"condition_codes": [
"112"
]
},
{
"qualification_code": 216,
"condition_codes": [
"111"
]
},
{
"qualification_code": 219,
"condition_codes": [
"111"
]
},
{
"qualification_code": 245,
"condition_codes": [
"111"
]
},
{
"qualification_code": 1032,
"condition_codes": [
"111"
]
}
],
"group_key": "Gender-Hispanic Group"
}
],
"qualifications": [
{
"qualification_code": 211,
"condition_codes": [
"111",
"112",
"113"
]
},
{
"qualification_code": 245,
"condition_codes": [
"111",
"112"
]
},
{
"qualification_code": 219,
"condition_codes": [
"111",
"112"
]
},
{
"qualification_code": 215,
"condition_codes": [
"111",
"112",
"113",
"114"
]
},
{
"qualification_code": 216,
"condition_codes": [
"111",
"112",
"113",
"114"
]
},
{
"qualification_code": 1032,
"condition_codes": [
"111",
"112",
"113",
"114"
]
}
]
}Response -
Response Code:
CODE: 200 OK
Response Body:
{
"aida": {
"enabled": false,
"selected_quota_ids": []
},
"qbp": {
"enable": false
},
"qlc": {
"enable": false,
"multiple_quotas": {
"enable": false,
"count_by_quota": false,
"compensate_by_quota": false
}
},
"soft_launch": {
"enable": false
},
"unique_links": {
"enable": false
},
"click_balancing": 0,
"estimated_clicks": 0,
"survey_external_id": "",
"ps_survey_status": 11,
"offer_price": 8,
"incl_excl": 0,
"quota_throttling": false,
"url_transform": false,
"subscriber_emails": [],
"survey_title": "Multi-Nested Quota survey",
"survey_category_code": 231,
"completes_required": 100,
"field_time": 20,
"buyer_message": null,
"is_modular_survey": false,
"live_url": "https://take-stage.purespectrum.com/mp_redirection",
"billing_id": "PS1181955",
"test_url": null,
"expected_loi": 5,
"expected_ir": 50,
"ps_survey_id": 1181955,
"buyer_surveygroup_ref": null,
"buyer_surveygroup_refs": [],
"test_ps_survey_entry_link": "https://qa3-api.spectrumsurveys.com/#/start-survey?survey_id=1181955&ps_redirect_test=1&bsec=a70mx8&supplier_id=23",
"survey_localization": "en_US",
"uniqueLinks": false,
"quotas": [
{
"buyer_quota_id": "b1",
"quota_title": "",
"ps_quota_id": "06483bf5-4616-4e06-82c4-609ae33accdf",
"required_count": 30,
"criteria": [
{
"qualification_code": 211,
"condition_codes": [
"111"
]
},
{
"qualification_code": 215,
"condition_codes": [
"111"
]
},
{
"qualification_code": 216,
"condition_codes": [
"111"
]
},
{
"qualification_code": 219,
"condition_codes": [
"111"
]
},
{
"qualification_code": 245,
"condition_codes": [
"111"
]
},
{
"qualification_code": 1032,
"condition_codes": [
"111"
]
}
],
"group_key": "Gender-Hispanic Group"
},
{
"buyer_quota_id": "b2",
"quota_title": "",
"ps_quota_id": "f503ebc0-e1f6-4add-a328-576bcb7baf4c",
"required_count": 30,
"criteria": [
{
"qualification_code": 211,
"condition_codes": [
"112"
]
},
{
"qualification_code": 215,
"condition_codes": [
"111"
]
},
{
"qualification_code": 216,
"condition_codes": [
"111"
]
},
{
"qualification_code": 219,
"condition_codes": [
"111"
]
},
{
"qualification_code": 245,
"condition_codes": [
"111"
]
},
{
"qualification_code": 1032,
"condition_codes": [
"111"
]
}
],
"group_key": "Gender-Hispanic Group"
},
{
"buyer_quota_id": "b3",
"quota_title": "",
"ps_quota_id": "9717ca97-af56-475d-b65a-9421319be91a",
"required_count": 40,
"criteria": [
{
"qualification_code": 211,
"condition_codes": [
"112"
]
},
{
"qualification_code": 215,
"condition_codes": [
"112"
]
},
{
"qualification_code": 216,
"condition_codes": [
"111"
]
},
{
"qualification_code": 219,
"condition_codes": [
"111"
]
},
{
"qualification_code": 245,
"condition_codes": [
"111"
]
},
{
"qualification_code": 1032,
"condition_codes": [
"111"
]
}
],
"group_key": "Gender-Hispanic Group"
}
],
"qualifications": [
{
"condition_codes": [
"111",
"112",
"113"
],
"qualification_code": 211
},
{
"condition_codes": [
"111",
"112",
"113",
"114"
],
"qualification_code": 215
},
{
"condition_codes": [
"111",
"112",
"113",
"114"
],
"qualification_code": 216
},
{
"condition_codes": [
"111",
"112"
],
"qualification_code": 219
},
{
"condition_codes": [
"111",
"112"
],
"qualification_code": 245
},
{
"condition_codes": [
"111",
"112",
"113",
"114"
],
"qualification_code": 1032
}
],
"is_feot_enabled": false,
"feot": {},
"survey_grouping": [],
"blend_id": null,
"schedule_launch": {
"enable": false,
"info": {
"date": null,
"hours": null,
"minutes": null,
"timezone": null,
"dateTimeInISO": null
}
},
"price_reco": false,
"project_creation_date": "2025-05-30T10:40:48.916Z",
"project_last_complete_date": null,
"is_dq_enable": false,
"mc_count": 0,
"tc_count": 0,
"basic_token": {
"enable": false,
"value": null
},
"is_pure_price_rate_card_enable": true,
"dq_settings": {
"purescore_filter_enabled": true,
"fp_device_check": true,
"fp_fraud_check": true
},
"product": "",
"pds_ignore_override": false,
"supplier_allocation_throttle": true,
"blend_applied": false
}Case 3
Suppose, the user sends two same nested quota criteria, even though the quotas belong to the different Nesting Groups.
Request -
Request URL:
POST <BASE_URL>/buyers/v2/surveys
headers - access-token: <BUYER_ACCESS_TOKEN>Request Body:
{
"expected_ir": 50,
"expected_loi": 5,
"live_url": "https://take-stage.purespectrum.com/mp_redirection",
"survey_title": "Multi-Nested Quota survey",
"survey_category_code": 231,
"completes_required": 100,
"offer_price": 8.00,
"field_time": 20,
"survey_localization": "en_US",
"quotas": [
{
"buyer_quota_id": "1",
"required_count": 30,
"criteria": [
{
"qualification_code": 211,
"condition_codes": [
"111"
]
},
{
"qualification_code": 245,
"condition_codes": [
"111"
]
}
],
"group_key": "Group 1"
},
{
"buyer_quota_id": "2",
"required_count": 50,
"criteria": [
{
"qualification_code": 211,
"condition_codes": [
"111"
]
},
{
"qualification_code": 245,
"condition_codes": [
"111"
]
}
],
"group_key": "Group 1"
}
],
"qualifications": [
{
"qualification_code": 211,
"condition_codes": [
"111",
"112",
"113"
]
},
{
"qualification_code": 245,
"condition_codes": [
"111",
"112"
]
},
{
"qualification_code": 219,
"condition_codes": [
"111",
"112"
]
}
]
}Response -
Response Code:
CODE: 400 BAD
Response Body:
{
"ps_api_response_code": 1002,
"ps_api_response_message": "Duplicate quota can't be create. Please check your quotas and try again."
}
Multi-Nested Quotas Updation
Case 1
Suppose, now we want to update Nesting Groups with these configurations -
Male - Yes, Male - No, Female - Yes and Female - No Nested Quotas brought together and their Nesting Group name updated to Gender-Hispanic Group and their allocation is updated too.
Request -
Request URL:
PUT <BASE_URL>/buyers/v2/surveys/<SURVEY_ID>
headers - access-token: <BUYER_ACCESS_TOKEN>Request Body:
{
"expected_ir": 50,
"expected_loi": 5,
"live_url": "https://take-stage.purespectrum.com/mp_redirection",
"survey_title": "Multi-Nested Quota survey",
"survey_category_code": 231,
"completes_required": 100,
"offer_price": 8.00,
"field_time": 20,
"survey_localization": "en_US",
"quotas": [
{
"buyer_quota_id": "male-yes",
"required_count": 10,
"criteria": [
{
"qualification_code": 211,
"condition_codes": [
"111"
]
},
{
"qualification_code": 245,
"condition_codes": [
"111"
]
}
],
"group_key": "Gender-Hispanic Group"
},
{
"buyer_quota_id": "male-no",
"required_count": 10,
"criteria": [
{
"qualification_code": 211,
"condition_codes": [
"111"
]
},
{
"qualification_code": 245,
"condition_codes": [
"112"
]
}
],
"group_key": "Gender-Hispanic Group"
},
{
"buyer_quota_id": "female-yes",
"required_count": 30,
"criteria": [
{
"qualification_code": 211,
"condition_codes": [
"112"
]
},
{
"qualification_code": 245,
"condition_codes": [
"111"
]
}
],
"group_key": "Gender-Hispanic Group"
},
{
"buyer_quota_id": "female-no",
"required_count": 50,
"criteria": [
{
"qualification_code": 211,
"condition_codes": [
"112"
]
},
{
"qualification_code": 245,
"condition_codes": [
"112"
]
}
],
"group_key": "Gender-Hispanic Group"
},
{
"buyer_quota_id": "desktop-yes",
"required_count": 70,
"criteria": [
{
"qualification_code": 219,
"condition_codes": [
"111"
]
},
{
"qualification_code": 245,
"condition_codes": [
"111"
]
}
],
"group_key": "Device-Hispanic Group"
},
{
"buyer_quota_id": "mobile-no",
"required_count": 30,
"criteria": [
{
"qualification_code": 219,
"condition_codes": [
"112"
]
},
{
"qualification_code": 245,
"condition_codes": [
"112"
]
}
],
"group_key": "Device-Hispanic Group"
}
],
"qualifications": [
{
"qualification_code": 211,
"condition_codes": [
"111",
"112",
"113"
]
},
{
"qualification_code": 245,
"condition_codes": [
"111",
"112"
]
},
{
"qualification_code": 219,
"condition_codes": [
"111",
"112"
]
}
]
}Response -
Response Code:
CODE: 200 OK
Response Body:
{
"aida": {
"enabled": false,
"selected_quota_ids": []
},
"qbp": {
"enable": false
},
"qlc": {
"enable": false,
"multiple_quotas": {
"enable": false,
"count_by_quota": false,
"compensate_by_quota": false
}
},
"soft_launch": {
"enable": false
},
"unique_links": {
"enable": false
},
"click_balancing": 0,
"estimated_clicks": 0,
"survey_external_id": "",
"ps_survey_status": 11,
"offer_price": 8,
"incl_excl": 0,
"quota_throttling": false,
"url_transform": false,
"subscriber_emails": [
"tanmaybuyerui2@gmail.com"
],
"survey_title": "Multi-Nested Quota survey",
"survey_category_code": 231,
"completes_required": 100,
"field_time": 20,
"buyer_message": null,
"is_modular_survey": false,
"live_url": "https://take-stage.purespectrum.com/mp_redirection",
"billing_id": "PS1181478",
"test_url": null,
"expected_loi": 5,
"expected_ir": 50,
"ps_survey_id": 1181478,
"buyer_surveygroup_ref": null,
"buyer_surveygroup_refs": [],
"test_ps_survey_entry_link": "https://qa3-api.spectrumsurveys.com/#/start-survey?survey_id=1181478&ps_redirect_test=1&bsec=a70mx8&supplier_id=23",
"survey_localization": "en_US",
"uniqueLinks": false,
"quotas": [
{
"buyer_quota_id": "male-yes",
"quota_title": "",
"ps_quota_id": "0c721c3b-dce1-46b2-ba93-2eaa853ab801",
"required_count": 10,
"criteria": [
{
"qualification_code": 211,
"condition_codes": [
"111"
]
},
{
"qualification_code": 245,
"condition_codes": [
"111"
]
}
],
"group_key": "Gender-Hispanic Group"
},
{
"buyer_quota_id": "male-no",
"quota_title": "",
"ps_quota_id": "b56fcdef-c210-4b71-9f18-0d9b6842272e",
"required_count": 10,
"criteria": [
{
"qualification_code": 211,
"condition_codes": [
"111"
]
},
{
"qualification_code": 245,
"condition_codes": [
"112"
]
}
],
"group_key": "Gender-Hispanic Group"
},
{
"buyer_quota_id": "female-yes",
"quota_title": "",
"ps_quota_id": "dc530f26-05e8-4a7b-8d39-ae0d6d9a156e",
"required_count": 30,
"criteria": [
{
"qualification_code": 211,
"condition_codes": [
"112"
]
},
{
"qualification_code": 245,
"condition_codes": [
"111"
]
}
],
"group_key": "Gender-Hispanic Group"
},
{
"buyer_quota_id": "female-no",
"quota_title": "",
"ps_quota_id": "c65e3cd5-fd45-4c05-9ba4-6e5500f6f4ea",
"required_count": 50,
"criteria": [
{
"qualification_code": 211,
"condition_codes": [
"112"
]
},
{
"qualification_code": 245,
"condition_codes": [
"112"
]
}
],
"group_key": "Gender-Hispanic Group"
},
{
"buyer_quota_id": "desktop-yes",
"quota_title": "",
"ps_quota_id": "c952530a-19c2-4df0-b7ac-a32755bf1c39",
"required_count": 70,
"criteria": [
{
"qualification_code": 219,
"condition_codes": [
"111"
]
},
{
"qualification_code": 245,
"condition_codes": [
"111"
]
}
],
"group_key": "Device-Hispanic Group"
},
{
"buyer_quota_id": "mobile-no",
"quota_title": "",
"ps_quota_id": "227fbcfb-5a4c-4fb2-97ea-b63dc472b637",
"required_count": 30,
"criteria": [
{
"qualification_code": 219,
"condition_codes": [
"112"
]
},
{
"qualification_code": 245,
"condition_codes": [
"112"
]
}
],
"group_key": "Device-Hispanic Group"
}
],
"qualifications": [
{
"condition_codes": [
"111",
"112",
"113"
],
"qualification_code": 211
},
{
"condition_codes": [
"111",
"112"
],
"qualification_code": 219
},
{
"condition_codes": [
"111",
"112"
],
"qualification_code": 245
}
],
"is_feot_enabled": false,
"feot": {},
"survey_grouping": [
1181478
],
"blend_id": null,
"schedule_launch": {
"enable": false,
"info": {}
},
"price_reco": false,
"project_creation_date": "2025-05-29T15:28:15.413Z",
"project_last_complete_date": null,
"is_dq_enable": false,
"mc_count": 0,
"tc_count": 0,
"basic_token": {
"enable": false,
"value": null
},
"is_pure_price_rate_card_enable": true,
"dq_settings": {
"purescore_filter_enabled": true,
"fp_device_check": true,
"fp_fraud_check": true
},
"product": "",
"pds_ignore_override": false,
"supplier_allocation_throttle": true
}Case 2
Suppose, we delete Male - Yes, Male - No, and Device-Hispanic Group Nested Quotas just as to replicate the similar behaviour from the Multi-Quota Nested modal in UI, then Male Quota will be saved as Layered Quota (Because it is no longer part of Nested Quota)
Request -
Request URL:
PUT <BASE_URL>/buyers/v2/surveys/<SURVEY_ID>
headers - access-token: <BUYER_ACCESS_TOKEN>Request Body:
{
"expected_ir": 50,
"expected_loi": 5,
"live_url": "https://take-stage.purespectrum.com/mp_redirection",
"survey_title": "Multi-Nested Quota survey",
"survey_category_code": 231,
"completes_required": 100,
"offer_price": 8.00,
"field_time": 20,
"survey_localization": "en_US",
"quotas": [
{
"buyer_quota_id": "male",
"required_count": 10,
"criteria": [
{
"qualification_code": 211,
"condition_codes": [
"111"
]
}
]
},
{
"buyer_quota_id": "female-yes",
"required_count": 30,
"criteria": [
{
"qualification_code": 211,
"condition_codes": [
"112"
]
},
{
"qualification_code": 245,
"condition_codes": [
"111"
]
}
],
"group_key": "Gender-Hispanic Group"
},
{
"buyer_quota_id": "female-no",
"required_count": 50,
"criteria": [
{
"qualification_code": 211,
"condition_codes": [
"112"
]
},
{
"qualification_code": 245,
"condition_codes": [
"112"
]
}
],
"group_key": "Gender-Hispanic Group"
}
],
"qualifications": [
{
"qualification_code": 211,
"condition_codes": [
"111",
"112",
"113"
]
},
{
"qualification_code": 245,
"condition_codes": [
"111",
"112"
]
},
{
"qualification_code": 219,
"condition_codes": [
"111",
"112"
]
}
]
}Response -
Response Code:
CODE: 200 OK
Response Body:
{
"aida": {
"enabled": false,
"selected_quota_ids": []
},
"qbp": {
"enable": false
},
"qlc": {
"enable": false,
"multiple_quotas": {
"enable": false,
"count_by_quota": false,
"compensate_by_quota": false
}
},
"soft_launch": {
"enable": false
},
"unique_links": {
"enable": false
},
"click_balancing": 0,
"estimated_clicks": 0,
"survey_external_id": "",
"ps_survey_status": 11,
"offer_price": 8,
"incl_excl": 0,
"quota_throttling": false,
"url_transform": false,
"subscriber_emails": [
"tanmaybuyerui2@gmail.com"
],
"survey_title": "Multi-Nested Quota survey",
"survey_category_code": 231,
"completes_required": 100,
"field_time": 20,
"buyer_message": null,
"is_modular_survey": false,
"live_url": "https://take-stage.purespectrum.com/mp_redirection",
"billing_id": "PS1181478",
"test_url": null,
"expected_loi": 5,
"expected_ir": 50,
"ps_survey_id": 1181478,
"buyer_surveygroup_ref": null,
"buyer_surveygroup_refs": [],
"test_ps_survey_entry_link": "https://qa3-api.spectrumsurveys.com/#/start-survey?survey_id=1181478&ps_redirect_test=1&bsec=a70mx8&supplier_id=23",
"survey_localization": "en_US",
"uniqueLinks": false,
"quotas": [
{
"buyer_quota_id": "male",
"quota_title": "",
"ps_quota_id": "add1c483-d175-4014-9f6e-761e73351c3e",
"required_count": 10,
"criteria": [
{
"qualification_code": 211,
"condition_codes": [
"111"
]
}
]
},
{
"buyer_quota_id": "female-yes",
"quota_title": "",
"ps_quota_id": "dc530f26-05e8-4a7b-8d39-ae0d6d9a156e",
"required_count": 30,
"criteria": [
{
"qualification_code": 211,
"condition_codes": [
"112"
]
},
{
"qualification_code": 245,
"condition_codes": [
"111"
]
}
],
"group_key": "Gender-Hispanic Group"
},
{
"buyer_quota_id": "female-no",
"quota_title": "",
"ps_quota_id": "c65e3cd5-fd45-4c05-9ba4-6e5500f6f4ea",
"required_count": 50,
"criteria": [
{
"qualification_code": 211,
"condition_codes": [
"112"
]
},
{
"qualification_code": 245,
"condition_codes": [
"112"
]
}
],
"group_key": "Gender-Hispanic Group"
}
],
"qualifications": [
{
"condition_codes": [
"111",
"112",
"113"
],
"qualification_code": 211
},
{
"condition_codes": [
"111",
"112"
],
"qualification_code": 219
},
{
"condition_codes": [
"111",
"112"
],
"qualification_code": 245
}
],
"is_feot_enabled": false,
"feot": {},
"survey_grouping": [
1181478
],
"blend_id": null,
"schedule_launch": {
"enable": false,
"info": {}
},
"price_reco": false,
"project_creation_date": "2025-05-29T15:28:15.413Z",
"project_last_complete_date": null,
"is_dq_enable": false,
"mc_count": 0,
"tc_count": 0,
"basic_token": {
"enable": false,
"value": null
},
"is_pure_price_rate_card_enable": true,
"dq_settings": {
"purescore_filter_enabled": true,
"fp_device_check": true,
"fp_fraud_check": true
},
"product": "",
"pds_ignore_override": false,
"supplier_allocation_throttle": true
}Case 3
Suppose, we keep only one Female - Yes Nested Quota in the Gender-Hispanic Group Nesting Group.
Request -
Request URL:
PUT <BASE_URL>/buyers/v2/surveys/<SURVEY_ID>
headers - access-token: <BUYER_ACCESS_TOKEN>Request Body:
{
"expected_ir": 50,
"expected_loi": 5,
"live_url": "https://take-stage.purespectrum.com/mp_redirection",
"survey_title": "Multi-Nested Quota survey",
"survey_category_code": 231,
"completes_required": 100,
"offer_price": 8.00,
"field_time": 20,
"survey_localization": "en_US",
"quotas": [
{
"buyer_quota_id": "female-yes",
"required_count": 30,
"criteria": [
{
"qualification_code": 211,
"condition_codes": [
"112"
]
},
{
"qualification_code": 245,
"condition_codes": [
"111"
]
}
],
"group_key": "Gender-Hispanic Group"
}
],
"qualifications": [
{
"qualification_code": 211,
"condition_codes": [
"111",
"112",
"113"
]
},
{
"qualification_code": 245,
"condition_codes": [
"111",
"112"
]
},
{
"qualification_code": 219,
"condition_codes": [
"111",
"112"
]
}
]
}Response -
Response Code:
CODE: 200 OK
Response Body:
{
"aida": {
"enabled": false,
"selected_quota_ids": []
},
"qbp": {
"enable": false
},
"qlc": {
"enable": false,
"multiple_quotas": {
"enable": false,
"count_by_quota": false,
"compensate_by_quota": false
}
},
"soft_launch": {
"enable": false
},
"unique_links": {
"enable": false
},
"click_balancing": 0,
"estimated_clicks": 0,
"survey_external_id": "",
"ps_survey_status": 11,
"offer_price": 8,
"incl_excl": 0,
"quota_throttling": false,
"url_transform": false,
"subscriber_emails": [
"tanmaybuyerui2@gmail.com"
],
"survey_title": "Multi-Nested Quota survey",
"survey_category_code": 231,
"completes_required": 100,
"field_time": 20,
"buyer_message": null,
"is_modular_survey": false,
"live_url": "https://take-stage.purespectrum.com/mp_redirection",
"billing_id": "PS1181478",
"test_url": null,
"expected_loi": 5,
"expected_ir": 50,
"ps_survey_id": 1181478,
"buyer_surveygroup_ref": null,
"buyer_surveygroup_refs": [],
"test_ps_survey_entry_link": "https://qa3-api.spectrumsurveys.com/#/start-survey?survey_id=1181478&ps_redirect_test=1&bsec=a70mx8&supplier_id=23",
"survey_localization": "en_US",
"uniqueLinks": false,
"quotas": [
{
"buyer_quota_id": "female-yes",
"quota_title": "",
"ps_quota_id": "dc530f26-05e8-4a7b-8d39-ae0d6d9a156e",
"required_count": 30,
"criteria": [
{
"qualification_code": 211,
"condition_codes": [
"112"
]
},
{
"qualification_code": 245,
"condition_codes": [
"111"
]
}
],
"group_key": "Gender-Hispanic Group"
}
],
"qualifications": [
{
"condition_codes": [
"111",
"112",
"113"
],
"qualification_code": 211
},
{
"condition_codes": [
"111",
"112"
],
"qualification_code": 219
},
{
"condition_codes": [
"111",
"112"
],
"qualification_code": 245
}
],
"is_feot_enabled": false,
"feot": {},
"survey_grouping": [
1181478
],
"blend_id": null,
"schedule_launch": {
"enable": false,
"info": {}
},
"price_reco": false,
"project_creation_date": "2025-05-29T15:28:15.413Z",
"project_last_complete_date": null,
"is_dq_enable": false,
"mc_count": 0,
"tc_count": 0,
"basic_token": {
"enable": false,
"value": null
},
"is_pure_price_rate_card_enable": true,
"dq_settings": {
"purescore_filter_enabled": true,
"fp_device_check": true,
"fp_fraud_check": true
},
"product": "",
"pds_ignore_override": false,
"supplier_allocation_throttle": true
}