We hope you enjoy our updated documentation! The old documentation website is still available here. Reach out to us with feedback or questions. Happy programming! 🎉

Add quota

POST

/surveys/{SURVEY_ID}/quotas

Last modified:2025-07-20 19:21:14

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

Path Params

Query Params

Header 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

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

Ethnicity quotaCustom quota_titleManage quotas by supplier

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

Responses

🟢201Created

application/json

Body

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"
            ]
        }
    ]
}

🟠409Bad Request Conflict

🟠400Bad Request

Modified at 2025-07-20 19:21:14

Quotas

Update quota