Update status of transaction (V2)

POST

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

Last modified:2025-10-05 17:11:47

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 V2 version of the Buyer API.

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

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

Although the V2 version is still operational, there a new V3 version that returns a faster response and additional useful information in the response body. Update status of transaction (V3)

Request

Authorization

Add parameter in header

access-token

Example:

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

Path Params

Query Params

Request Code Samples

Shell

JavaScript

Java

PHP

Python

Ruby

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

Responses

🟢200Success

This response does not have a body.

🟠400Bad Request

🔴500Server Error

Modified at 2025-10-05 17:11:47

Transactions