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

Update status of transaction (V3)

POST

/surveys/{SURVEY_ID}/transactions/{TRANSACTION_ID}/status

Last modified:2025-07-20 19:25:11

Description

If this endpoint is called, and the respondent is later redirected to PureSpectrum via the /surveydone redirect, the status of the original API call will be trusted as the source of truth.

For example - the API call is made with st=18 (termination), but the respondent is redirected later with st=21 (complete), we will continue to recognize the transaction as a termination.

Transaction can be changed only if is on these 3 states:

Buyer side in progress

Buyer drop

PS LOI Threshold Failure

This endpoint is using the V3 version of the Buyer API.

Staging: https://staging.spectrumsurveys.com/buyers/v3

Production: https://api.spectrumsurveys.com/buyers/v3

Although the V2 version is still operational, this new version returns a faster response and additional useful information in the response body.

Request

Path Params

Query Params

Header Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://staging.spectrumsurveys.com/buyers/v3/surveys//transactions//status?st=21&quota_id=qb1' \
--header 'access-token: '

Responses

🟢200Success

application/json

Body

Example

{
    "status": 21,
    "status_description": "Complete",
    "reconciled": false,
    "reconciliation_info": null
}

🟠400Bad Request

🟠403Forbidden

🟠401Unauthorized

Modified at 2025-07-20 19:25:11

Update status of transaction (V2)