PureSpectrum
PureSpectrum websiteHelp center
PureSpectrum websiteHelp center
  1. Surveys
  • Back to home
  • API Reference
  • Feasibility
    • Feasibility & Pricing
  • Attributes
    • Get attribute (V3)
    • Get attributes (V3)
  • Surveys
    • Create survey
      POST
    • Get similar surveys
      POST
    • Create group multi-country surveys
      POST
    • Update survey
      PATCH
    • Update survey
      PUT
    • Update survey status
      PUT
    • Update offer price
      PUT
    • Update group multi-country surveys
      PUT
    • Get survey information
      GET
    • Get survey status
      GET
    • Get survey performance
      GET
    • Get list of all surveys
      GET
    • Surveys health status
      GET
    • Pacing details
      GET
    • Delete survey
      DELETE
  • Qualifications
    • Add qualification
    • Update qualification
    • Get qualification information
    • Get all qualifications
    • Delete qualification
  • Quotas
    • Add quota
    • Update quota
    • Update quota
    • Get quota information
    • Get quota performance
    • Delete quota
  • Survey group exclusions
    • Create exclusion group
    • Update exclusion group
    • Get exclusion group information
    • Delete exclusion group
  • Respondent inclusion / exclusion
    • Add a PSIDref list to a survey
    • Update a PSIDref for survey
    • Get PSIDref list for survey
  • Supplier management
    • Create supplier blend
    • Update the list of suppliers for a survey
    • Get list of available suppliers in a locale
    • Get list of available suppliers for a survey
    • Get list of supplier blends
  • Traffic Channels
    • Create traffic channel
    • Get a list of traffic channels
  • Transactions
    • Update status of transaction (V2)
    • Update status of transaction (V3)
    • Register transaction as complete
    • Get transaction status (V3)
    • Get transaction info (V3)
    • Get transactions info for a survey ID (V3)
  • Reconciliation
    • Survey reconciliation
    • Multi survey reconciliation
    • Get status of a reconciliation request
    • Get reconciliation status for an adjustment ID
  • PureText
    • PureText Open-ended (OE) check (V3)
  • Activity logs
    • Get activity logs
    • Get events
  • Templates
    • Get survey templates
  1. Surveys

Get list of all surveys

GET
/surveys
Last modified:2025-10-05 16:50:51

Description#

This endpoint will return surveys that are live by default. You may use the query string parameter status to retrieve surveys of a different status.

Request

Authorization
Add parameter in header
access-token
Example:
access-token: ********************
Query Params

Request Code Samples

Shell
JavaScript
Java
Go
PHP
Python
C#
Ruby
Request Request Example
Shell
JavaScript
Java
Go
curl --location 'https://staging.spectrumsurveys.com/buyers/v2/surveys?status=11&fromDate=20250101&toDate=20251231&targeting=0&limit=5&page=2' \
--header 'access-token: <api-key>'

Responses

🟢200Get list of all surveys 200
application/json
Bodyapplication/json

Example
The number of surveys returned is only an example.
[
    {
        "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": 3.25,
        "incl_excl": 0,
        "quota_throttling": false,
        "url_transform": false,
        "subscriber_emails": [],
        "survey_title": "Test Florina TEMP 2",
        "survey_category_code": 231,
        "completes_required": 300,
        "field_time": 10,
        "buyer_message": null,
        "is_modular_survey": false,
        "live_url": "https://my.survey.com?survey_id=1234",
        "billing_id": "PS1118404",
        "test_url": "https://my.survey.com?survey_id=1234&amp;test=1",
        "expected_loi": 10,
        "expected_ir": 60,
        "ps_survey_id": 41234567,
        "buyer_surveygroup_ref": null,
        "buyer_surveygroup_refs": [],
        "test_ps_survey_entry_link": "https://staging.spectrumsurveys.com/#/start-survey?survey_id=1118404&ps_redirect_test=1&bsec=a70mx8&supplier_id=23",
        "survey_localization": "en_US",
        "is_feot_enabled": false,
        "feot": {},
        "blend_id": null,
        "schedule_launch": {
            "enable": false,
            "info": {
                "date": null,
                "hours": null,
                "minutes": null,
                "timezone": null,
                "dateTimeInISO": null
            }
        },
        "project_creation_date": "2025-03-07T20:51:43.426Z",
        "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
    },
    {
        "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": "23wrfaes",
        "survey_category_code": 232,
        "completes_required": 2,
        "field_time": 4,
        "buyer_message": null,
        "is_modular_survey": false,
        "live_url": null,
        "billing_id": "PS1118388",
        "test_url": null,
        "expected_loi": 2,
        "expected_ir": 4,
        "ps_survey_id": 41234568,
        "buyer_surveygroup_ref": null,
        "buyer_surveygroup_refs": [],
        "test_ps_survey_entry_link": "https://staging.spectrumsurveys.com/#/start-survey?survey_id=1118388&ps_redirect_test=1&bsec=a70mx8&supplier_id=23",
        "survey_localization": "en_US",
        "is_feot_enabled": false,
        "feot": {},
        "blend_id": null,
        "schedule_launch": {
            "enable": false,
            "info": {
                "date": null,
                "hours": null,
                "minutes": null,
                "timezone": null,
                "dateTimeInISO": null
            }
        },
        "project_creation_date": "2025-03-07T18:39:50.666Z",
        "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
    }
]
🟠401Unauthorized
Modified at 2025-10-05 16:50:51
Previous
Get survey performance
Next
Surveys health status