Add quota

POST

/surveys/{SURVEY_ID}/quotas

Last modified:2025-10-05 16:58:23

Description

This endpoint creates quotas for your survey via the API. Quotas allow you to control the number of completed responses you receive from specific subgroups of respondents based on defined criteria. By setting up quotas, you can ensure your survey results reflect your desired target audience composition.

Extended Usage

Renaming a Quota

Managing Quotas by supplier

Count quotas on clicks instead of completes

Request

Authorization

Add parameter in header

access-token

Example:

access-token: ********************

Path Params

Query Params

Body Params application/json

Examples

Ethnicity quotaCustom quota_titleManage quotas by supplier

Example ethnicity quota

{
    "buyer_quota_id": "Q1",
    "required_count": 200,
    "criteria": [
        {
            "qualification_code": 214,
            "condition_codes": [
                "112"
            ]
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

PHP

Python

Ruby

cURL

Ethnicity quotaCustom quota_titleManage quotas by supplier

curl --location 'https://staging.spectrumsurveys.com/buyers/v2/surveys/1234567/quotas?QBS=1' \
--header 'access-token: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "buyer_quota_id": "Q1",
    "required_count": 200,
    "criteria": [
        {
            "qualification_code": 214,
            "condition_codes": [
                "112"
            ]
        }
    ]
}'

Responses

🟢201Created

application/json

Bodyapplication/json

Examples

Example ethnicity quotaManaged quotas by supplier

Example ethnicity quota

{
    "buyer_quota_id": "Q1",
    "ps_quota_id": "cdf63e8b-530d-4a1c-b649-ceb676e773cd",
    "required_count": 200,
    "criteria": [
        {
            "qualification_code": 214,
            "condition_codes": [
                "112"
            ]
        }
    ]
}

🟠400Bad Request

🟠409Bad Request Conflict

Modified at 2025-10-05 16:58:23

Quotas

Update quota