We hope you enjoy our updated documentation! The old documentation website is still available here. Reach out to us with feedback or questions. Happy programming! 🎉
- Feasibility
- Attributes
- Surveys
- Create surveyPOST
- Get similar surveysPOST
- Create group multi-country surveysPOST
- Update surveyPATCH
- Update surveyPUT
- Update survey statusPUT
- Update offer pricePUT
- Update group multi-country surveysPUT
- Get survey informationGET
- Get survey statusGET
- Get survey performanceGET
- Get list of all surveysGET
- Surveys health statusGET
- Delete surveyDELETE
- Qualifications in a survey
- Quotas
- Survey group exclusions
- Respondent inclusion / exclusion
- Supplier management
- Traffic Channels
- Transactions
- Reconciliation
- PureText
- Activity logs
- Templates
Update group multi-country surveys
PUT
/projects
Last modified:2025-08-08 21:52:02
Description#
Request
Header Params
Body Params application/json
Example
{
"survey_title": "Test MC",
"survey_category_code": 211,
"completes_required": 100,
"field_time": 10,
"live_url": "http://example.com/survey",
"expected_loi": 10,
"expected_ir": 10,
"survey_localizations": [
"en_US",
"es_US"
],
"surveys": [
{
"survey_localization": "es_US",
"completes_required": 51,
"survey_title": "Test MC Project 1",
"quotas": [
{
"buyer_quota_id": "bqID1",
"required_count": 50,
"criteria": [
{
"qualification_code": 211,
"condition_codes": [
"112"
]
}
]
}
],
"qualifications": [
{
"condition_codes": [
"112"
],
"qualification_code": 211
}
]
},
{
"survey_localization": "en_US",
"completes_required": 49,
"field_time": 9,
"live_url": "http://example.com/survey",
"survey_title": "Test MC Project 2",
"expected_loi": 9,
"expected_ir": 9
}
],
"quotas": [
{
"buyer_quota_id": "bqID2",
"required_count": 50,
"criteria": [
{
"qualification_code": 211,
"condition_codes": [
"111"
]
}
]
}
],
"qualifications": [
{
"condition_codes": [
"111"
],
"qualification_code": 211
}
]
}Request Code Samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PUT 'https://staging.spectrumsurveys.com/buyers/v2/projects' \
--header 'access-token: ' \
--header 'Content-Type: application/json' \
--data-raw '{
"survey_title": "Test MC",
"survey_category_code": 211,
"completes_required": 100,
"field_time": 10,
"live_url": "http://example.com/survey",
"expected_loi": 10,
"expected_ir": 10,
"survey_localizations": [
"en_US",
"es_US"
],
"surveys": [
{
"survey_localization": "es_US",
"completes_required": 51,
"survey_title": "Test MC Project 1",
"quotas": [
{
"buyer_quota_id": "bqID1",
"required_count": 50,
"criteria": [
{
"qualification_code": 211,
"condition_codes": [
"112"
]
}
]
}
],
"qualifications": [
{
"condition_codes": [
"112"
],
"qualification_code": 211
}
]
},
{
"survey_localization": "en_US",
"completes_required": 49,
"field_time": 9,
"live_url": "http://example.com/survey",
"survey_title": "Test MC Project 2",
"expected_loi": 9,
"expected_ir": 9
}
],
"quotas": [
{
"buyer_quota_id": "bqID2",
"required_count": 50,
"criteria": [
{
"qualification_code": 211,
"condition_codes": [
"111"
]
}
]
}
],
"qualifications": [
{
"condition_codes": [
"111"
],
"qualification_code": 211
}
]
}'Responses
🟢201Created
application/json
Body
Example
{
"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": null,
"incl_excl": 0,
"quota_throttling": false,
"url_transform": false,
"subscriber_emails": [],
"survey_title": "Test MC",
"survey_category_code": 211,
"completes_required": 100,
"field_time": 10,
"buyer_message": null,
"is_modular_survey": false,
"live_url": "http://example.com/survey",
"billing_id": "PS1161691",
"test_url": null,
"expected_loi": 10,
"expected_ir": 10,
"ps_survey_id": 1161691,
"buyer_surveygroup_ref": null,
"buyer_surveygroup_refs": [],
"test_ps_survey_entry_link": "https://staging.spectrumsurveys.com/#/start-survey?survey_id=1161691&ps_redirect_test=1&bsec=a70mx8&supplier_id=23",
"survey_localizations": [
"es_US",
"en_US"
],
"uniqueLinks": false,
"quotas": [],
"qualifications": [],
"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-04-30T20:50:55.138Z",
"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
}Modified at 2025-08-08 21:52:02