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

PATCH
/surveys/{SURVEY_ID}/quotas/{QUOTA_ID}
Last modified:2025-09-16 21:01:07

Description#

This endpoint allows you to update the current_target of an existing quota only, and no other parameters.

Request

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

Body Params application/json

Example
[
    {
        "op": "replace",
        "path": "/current_target",
        "value": 171
    }
]

Request Code Samples

Shell
JavaScript
Java
Go
PHP
Python
C#
Ruby
Request Request Example
Shell
JavaScript
Java
Go
curl --location --request PATCH 'https://staging.spectrumsurveys.com/buyers/v2/surveys//quotas/' \
--header 'access-token: <api-key>' \
--header 'Content-Type: application/json' \
--data '[
    {
        "op": "replace",
        "path": "/current_target",
        "value": 171
    }
]'

Responses

🟢200Success
application/json
Bodyapplication/json

Example
{
    "quota_id": "79ff0b80-4577-4819-8319-b6ef94c81a62",
    "quota_title": "",
    "buyer_quota_id": "qb12",
    "marker": "",
    "type": 0,
    "isActive": true,
    "locked": false,
    "quotaCategory": "layered",
    "criteria": [
        {
            "qualification_code": 211,
            "qualification_name": "Gender",
            "buyer_ziplist_ref": "",
            "q_type": "normal",
            "conditions": [
                {
                    "id": "111",
                    "name": "Male"
                }
            ],
            "range_sets": [],
            "original_flex": {
                "enable": false,
                "value": 0
            },
            "_id": "68474dd414bc60b53b175d42"
        }
    ],
    "suppliers": {
        "0": {
            "complete_needed": 400,
            "complete_fielded": 0,
            "total_starts": 0,
            "buyer_valid_clks": 0,
            "current_target": 171,
            "currently_open": 171,
            "sup_currently_open": 171,
            "bip": 0,
            "last_start_date": "",
            "last_complete_date": ""
        },
        "7": {
            "complete_needed": 400,
            "complete_fielded": 0,
            "total_starts": 0,
            "buyer_valid_clks": 0,
            "current_target": 171,
            "currently_open": 171,
            "sup_currently_open": 171,
            "bip": 0,
            "last_start_date": "",
            "last_complete_date": ""
        },
        "17": {
            "complete_needed": 400,
            "complete_fielded": 0,
            "total_starts": 0,
            "buyer_valid_clks": 0,
            "current_target": 171,
            "currently_open": 171,
            "sup_currently_open": 171,
            "bip": 0,
            "last_start_date": "",
            "last_complete_date": ""
        },
        "36": {
            "complete_needed": 400,
            "complete_fielded": 0,
            "total_starts": 0,
            "buyer_valid_clks": 0,
            "current_target": 171,
            "currently_open": 171,
            "sup_currently_open": 171,
            "bip": 0,
            "last_start_date": "",
            "last_complete_date": ""
        },
        "73": {
            "complete_needed": 400,
            "complete_fielded": 0,
            "total_starts": 0,
            "buyer_valid_clks": 0,
            "current_target": 171,
            "currently_open": 171,
            "sup_currently_open": 171,
            "bip": 0,
            "last_start_date": "",
            "last_complete_date": ""
        },
        "149": {
            "complete_needed": 400,
            "complete_fielded": 0,
            "total_starts": 0,
            "buyer_valid_clks": 0,
            "current_target": 171,
            "currently_open": 171,
            "sup_currently_open": 171,
            "bip": 0,
            "last_start_date": "",
            "last_complete_date": ""
        },
        "175": {
            "complete_needed": 400,
            "complete_fielded": 0,
            "total_starts": 0,
            "buyer_valid_clks": 0,
            "current_target": 171,
            "currently_open": 171,
            "sup_currently_open": 171,
            "bip": 0,
            "last_start_date": "",
            "last_complete_date": ""
        },
        "263": {
            "complete_needed": 400,
            "complete_fielded": 0,
            "total_starts": 0,
            "buyer_valid_clks": 0,
            "current_target": 171,
            "currently_open": 171,
            "sup_currently_open": 171,
            "bip": 0,
            "last_start_date": "",
            "last_complete_date": ""
        },
        "587": {
            "complete_needed": 400,
            "complete_fielded": 0,
            "total_starts": 0,
            "buyer_valid_clks": 0,
            "current_target": 171,
            "currently_open": 171,
            "sup_currently_open": 171,
            "bip": 0,
            "last_start_date": "",
            "last_complete_date": ""
        }
    },
    "quantities": {
        "currently_open": 171,
        "current_target": 171,
        "sup_currently_open": 171,
        "remaining": 171,
        "achieved": 0,
        "hasValidQuotas": true,
        "percentage": 40,
        "number": 400,
        "isFlexible": false,
        "flexibility": 0,
        "maximum": 400,
        "minimum": 400
    },
    "counter": {
        "Buyer_side_In_Progress": 0,
        "Buyer_Survey_Starts": 0,
        "Buyer_Valid_Clicks": 0
    },
    "individual_quotas": [],
    "priceRecommended": 0,
    "group_key": null,
    "crtd_on": 1749503444340,
    "mod_on": 1749503486733,
    "_id": "68474dd414bc60b53b175d41"
}
🟠400Bad Request
🟠404Record Not Found
Modified at 2025-09-16 21:01:07
Previous
Update quota
Next
Get quota information