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! 🎉

Get survey performance

GET

/surveys/{SURVEY_ID}/performance

Last modified:2025-10-05 16:50:36

Description

Get the performance details of a survey. You can use this endpoint for bid metrics to understand the number of:

overquotas

dropoffs

quality terminates

standard terminates

for a given bid. These would allow to understand our bid health in a more complete way via the API.

Request

Authorization

Add parameter in header

access-token

Example:

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

Path Params

Request Code Samples

Shell

JavaScript

Java

PHP

Python

Ruby

curl --location -g --request GET 'https://staging.spectrumsurveys.com/buyers/v2/surveys/{{SURVEY_ID}}/performance' \
--header 'access-token: <api-key>'

Responses

🟢200Success

application/json

Body

Example

{
    "ps_survey_status": 22,
    "completes_fielded": 958,
    "completes_goal": 1100,
    "cpi_forecast_at_launch": "0.28",
    "current_cpi": "0.28",
    "projected_acpi": "0.27",
    "total_cost_forecast_at_launch": "253.00",
    "current_cost": "268.24",
    "projected_total_cost": "301.00",
    "stated_loi": 3,
    "current_overall_loi": 3,
    "stated_incidence": 100,
    "current_overall_incidence": 35,
    "last_block_loi": null,
    "last_block_incidence": null,
    "over_quota_count": 1514,
    "drop_off_count": 201,
    "quality_termination_count": 274,
    "termination_count": 53,
    "survey_launch_ts": 1758377784177,
    "survey_close_ts": null,
    "survey_launch_iso_date": "2025-09-20T14:16:24.177Z",
    "survey_close_iso_date": null
}

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

Modified at 2025-10-05 16:50:36

Get survey status

Get list of all surveys

Get survey performance

Description#

Request

Request Code Samples

Responses

Description