PureSpectrum
PureSpectrum websiteHelp center
PureSpectrum websiteHelp center
  1. Supplier management
  • Back to home
  • API Reference
  • Feasibility
    • Feasibility & Pricing
  • Attributes
    • Get attribute (V3)
    • Get attributes (V3)
  • Surveys
    • Create survey
    • Get similar surveys
    • Create group multi-country surveys
    • Update survey
    • Update survey
    • Update survey status
    • Update offer price
    • Update group multi-country surveys
    • Get survey information
    • Get survey status
    • Get survey performance
    • Get list of all surveys
    • Surveys health status
    • Pacing details
    • Delete survey
  • 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
      POST
    • Update the list of suppliers for a survey
      PUT
    • Get list of available suppliers in a locale
      GET
    • Get list of available suppliers for a survey
      GET
    • Get list of supplier blends
      GET
  • 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. Supplier management

Get list of available suppliers for a survey

GET
/surveys/{SURVEY_ID}/suppliers
Last modified:2025-09-23 07:10:00

Description#

Every survey in PureSpectrum has a list of suppliers that send sample. To check the list of suppliers, and their performance on a survey, you may use this endpoint.
In order to get performance data the stats=1 querry parameter should be added to the endpoint.

Request

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

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/41234567/suppliers?stats=undefined' \
--header 'access-token: <api-key>'

Responses

🟢200Success
application/json
Bodyapplication/json

Example
Non exhaustive list of available suppliers for a survey.
[
    {
        "group_ref": null,
        "group_name": null,
        "completes_goal": 300,
        "current_target": 300,
        "remaining": 300,
        "fielded": 0,
        "currency_symbol": "£",
        "cpi": 3.25,
        "bid_cpi": null,
        "buyer_in_progress": 0,
        "last_start_date": "",
        "last_complete_date": "",
        "intent": {
            "intent_count": 1000,
            "intent_not_set": [
                7
            ],
            "intent_denied": [],
            "intent_accepted": [],
            "child_intent_stats": {}
        },
        "suppliers": [
            {
                "id": 7,
                "name": "Say For Example",
                "allocation": 100
            }
        ],
        "is_pds_applied": false,
        "ps_start_count_24": 0,
        "valid_clicks": 0,
        "valid_epc": 0,
        "valid_click_percentage": 0,
        "total_epc": 0,
        "srv_start_count": 0,
        "max_cpi": 3.25,
        "conversion_rate": 60
    },
    {
        "group_ref": null,
        "group_name": null,
        "completes_goal": 300,
        "current_target": 300,
        "remaining": 300,
        "fielded": 0,
        "currency_symbol": "£",
        "cpi": 3.25,
        "bid_cpi": null,
        "buyer_in_progress": 0,
        "last_start_date": "",
        "last_complete_date": "",
        "intent": {
            "intent_count": null,
            "intent_not_set": [
                12
            ],
            "intent_denied": [],
            "intent_accepted": [],
            "child_intent_stats": {}
        },
        "suppliers": [
            {
                "id": 12,
                "name": "Decision Analyst",
                "allocation": 100
            }
        ],
        "is_pds_applied": false,
        "ps_start_count_24": 0,
        "valid_clicks": 0,
        "valid_epc": 0,
        "valid_click_percentage": 0,
        "total_epc": 0,
        "srv_start_count": 0,
        "max_cpi": 3.25,
        "conversion_rate": 60
    }
]
🔴500Server Error
Modified at 2025-09-23 07:10:00
Previous
Get list of available suppliers in a locale
Next
Get list of supplier blends