PureSpectrum
PureSpectrum websiteHelp center
PureSpectrum websiteHelp center
    • Intro
    • API Overview
    • Definitions
    • Survey Lifecycle
    • Create Your First Survey
    • Redirect URLs
    • Changelog
    • HTTP Status Codes
    • General Reference Codes
      • Survey Status Codes
      • Respondent Status Codes
      • Survey Category Codes
      • Age Unit Codes
      • Currency Codes
      • Survey Localization Codes
    • Guides
      • Getting Started
      • Create Survey Examples
      • Multi-Country Surveys
      • Children Age & Gender
      • Append Respondent Demographics to the Survey Entry Link
      • Test Survey Flow
      • Supplier Blends & Groups
      • Respondent Exclusion / Recontact
      • Survey Exclusion Group
      • Quotas on Clicks
      • Field Evenly Over Time (FEOT)
      • Quota Based Pricing (QBP)
      • Quota Level Complete (QLC)
      • Quota Throttling
      • Templates
      • Bypassing Automatic Variable Mapping
      • Research Defender's Predupe
      • Subscriber Emails
      • Real-Time Notifications (SNS)
    • API Reference
    • Schemas
      • Feasibility
        • Feasibility request schema
        • Feasibility response schema
      • Surveys
        • Create survey full request schema
        • Create survey minimum request schema
        • Create survey response schema
        • Update survey status request schema
        • Update survey status response schema
        • Get survey status response
      • Qualifications
        • Qualification Schema
        • Create qualification request schema
      • Quotas
        • Quota Schema
        • Create quota request schema
        • Create quota response schema
      • Attributes
        • Get attributes response
      • Supplier management
        • Supplier
        • List of all suppliers response
        • List of all suppliers per survey response
        • Update the list of suppliers for a Survey request
        • Update the list of suppliers for a Survey response
      • Other
        • Generic error response

    API Overview

    API URLs#

    This is the URL structure of our API:
    🔗
    {Base URI}/{Module}/{API Version}/{Resource}
    eg: https://staging.spectrumsurveys.com/buyers/v2/surveys
    Each environment has a different URL:
    Staging Base URL - API: https://staging.spectrumsurveys.com/buyers/v2
    Production Base URL - API: https://api.spectrumsurveys.com/buyers/v2

    Authorisation#

    API access requires the authorization parameter in the request header.
    You will receive different keys for Production and Staging.

    Required Auth Parameter#

    Header ParameterTypeDescription
    access-tokenstringToken used to identify the authenticity of the user.
    Access tokens are issued by the PureSpectrum Product team. Your sales representative can facilitate that.
    Please do not expose your access-token to anyone or in public as this could compromise the integrity of your integration.
    Modified at 2025-04-08 11:00:24
    Previous
    Intro
    Next
    Definitions