PureSpectrum
PureSpectrum websiteHelp center
PureSpectrum websiteHelp center
  1. Quotas
  • 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
      POST
    • Update quota
      PUT
    • Update quota
      PATCH
    • Get quota information
      GET
    • Get quota performance
      GET
    • Delete quota
      DELETE
  • 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. Quotas

Update quota

PUT
/surveys/{SURVEY_ID}/quotas/{QUOTA_ID}
Last modified:2025-09-16 21:00:57

Description#

This endpoint allows you to adjust the parameters of an existing quota for a survey:
required count
criteria
There are various scenarios where you might need to update a quota quantity. Adjusting this value allows you to:
Decrease the number of completes requested for a specific quota
Increase the number of completes requested for a specific a quota
Close the quota by setting the required count to zero or the current number of completes
The required count per quota can be set to any value greater than or equal to 0.
If the new required count is less than or equal to the current number of completes for that specific quota, the quota will effectively receive no additional traffic.
Our system uses two parameters to manage and control traffic to a quota:
required_count: the maximum number of completes allowed for the quota (this is defined either at survey creation or updated via this endpoint)
current_target: the current number of completes being targeted. This is monitored internally and must always satisfy the following condition current_target ≤ required_count.

Request

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

Query Params

Body Params application/json

Example
{
  "required_count": 400,
  "criteria": [
    {
      "qualification_code": 214,
      "condition_codes": [
        "112"
      ]
    }
  ]
}

Request Code Samples

Shell
JavaScript
Java
Go
PHP
Python
C#
Ruby
Request Request Example
Shell
JavaScript
Java
Go
curl --location --request PUT 'https://staging.spectrumsurveys.com/buyers/v2/surveys//quotas/?QBS=undefined' \
--header 'access-token: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
  "required_count": 400,
  "criteria": [
    {
      "qualification_code": 214,
      "condition_codes": [
        "112"
      ]
    }
  ]
}'

Responses

🟢200Success
application/json
Bodyapplication/json

Example
{
    "buyer_quota_id": "Q1",
    "ps_quota_id": "84ef3125-d69e-4a00-bec5-d53d03405bb2",
    "required_count": 400,
    "criteria": [
        {
            "qualification_code": 214,
            "condition_codes": [
                "112"
            ]
        }
    ]
}
🟠400Bad Request
🟠404Record Not Found
Modified at 2025-09-16 21:00:57
Previous
Add quota
Next
Update quota