PureSpectrum
PureSpectrum websiteHelp center
PureSpectrum websiteHelp center
  1. Transactions
  • Back to home
  • API Reference
  • Feasibility
    • Feasibility & Pricing
  • Attributes
    • Get attribute (V3)
    • Get attributes (V3)
  • Surveys
    • Create survey
    • Get similar surveys
    • Create group multi-country surveys
    • Update survey
    • Update survey
    • Update survey status
    • Update offer price
    • Update group multi-country surveys
    • Get survey information
    • Get survey status
    • Get survey performance
    • Get list of all surveys
    • Surveys health status
    • Pacing details
    • Delete survey
  • Qualifications
    • Add qualification
    • Update qualification
    • Get qualification information
    • Get all qualifications
    • Delete qualification
  • Quotas
    • Add quota
    • Update quota
    • Update quota
    • Get quota information
    • Get quota performance
    • Delete quota
  • Survey group exclusions
    • Create exclusion group
    • Update exclusion group
    • Get exclusion group information
    • Delete exclusion group
  • Respondent inclusion / exclusion
    • Add a PSIDref list to a survey
    • Update a PSIDref for survey
    • Get PSIDref list for survey
  • Supplier management
    • Create supplier blend
    • Update the list of suppliers for a survey
    • Get list of available suppliers in a locale
    • Get list of available suppliers for a survey
    • Get list of supplier blends
  • Traffic Channels
    • Create traffic channel
    • Get a list of traffic channels
  • Transactions
    • Update status of transaction (V2)
      POST
    • Update status of transaction (V3)
      POST
    • Register transaction as complete
      POST
    • Get transaction status (V3)
      GET
    • Get transaction info (V3)
      GET
    • Get transactions info for a survey ID (V3)
      GET
  • Reconciliation
    • Survey reconciliation
    • Multi survey reconciliation
    • Get status of a reconciliation request
    • Get reconciliation status for an adjustment ID
  • PureText
    • PureText Open-ended (OE) check (V3)
  • Activity logs
    • Get activity logs
    • Get events
  • Templates
    • Get survey templates
  1. Transactions

Get transactions info for a survey ID (V3)

GET
/surveys/{SURVEY_ID}/transactions
Last modified:2025-10-05 17:17:56

Description#

This endpoint helps an external system to have the information linked to a transaction. It might be used to:
Understand the status and any changes due to an existing reconciliation
Date and Time of any redirections
Information about Supplier
Survey details
Screener Answers
The response will include the transactions belonging to traffic channels of the parent survey, as well.
Any date value has this format and timezone: MM-DD-YYYY HH:MM:SS.
Timezone is PST.
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

Authorization
Add parameter in header
access-token
Example:
access-token: ********************
Path Params

Query Params

Request Code Samples

Shell
JavaScript
Java
Go
PHP
Python
C#
Ruby
Request Request Example
Shell
JavaScript
Java
Go
curl --location 'https://staging.spectrumsurveys.com/buyers/v3/surveys//transactions?status=17%2C21&supplier_ids=2%2C100&page=1&limit=3' \
--header 'access-token: <api-key>'

Responses

🟢200Success
application/json
Headers

Bodyapplication/json

Example
[
	{
		"Survey ID": 41234568,
		"Parent ID": "41234567",
		"PSID": "PSID456",
		"Transaction ID": "TX789",
		"Project Name": "Traffic Survey Project",
		"Child Type": "TypeA",
		"Survey Country": "US",
		"Survey Language": "en",
		"Supplier ID": 101,
		"Supplier Name": "Supplier Inc.",
		"Supplier Group": "GroupA",
		"PO / Billing": "PO123456",
		"Requested By": "John Doe",
		"Supplier Respondent ID": "SRID789",
		"Supplier Sid": "SID101",
		"Buyer ID": 202,
		"Buyer Name": "Buyer Corp.",
		"PS Entry DateTime": "2024-06-01T12:00:00Z",
		"Buyer Survey Entry Datetime": "2024-06-01T12:05:00Z",
		"Buyer Survey Return Datetime": "2024-06-01T12:30:00Z",
		"PS Exit Datetime": "2024-06-01T12:35:00Z",
		"Respondent Status Code": 1,
		"Respondent Status Description": "Completed",
		"Offer ID": "OFFER123",
		"Respondent Source": "Online",
		"Expected Buyer CPI": 2.5,
		"Expected Buyer CPI Fx": 2,
		"Block": 0,
		"Is Block Factor": 0,
		"GPP": 10,
		"GPP LOI": 15,
		"GPP IR": 20,
		"Respondent LOI": 12,
		"Respondent Buyer CPI": 2.5,
		"Reconciliation Status": 1,
		"Reconciliation Date": "2024-06-02T09:00:00Z",
		"Reconciliation Reason": "Verified",
		"Transaction Original Status": "Active",
		"Transaction Original Description": "Initial transaction",
		"PM": "Jane Smith",
		"Buyer PM Email": "jane.smith@buyer.com",
		"Sub Supplier Name": "SubSupplier Ltd.",
		"PS_Termination Reason": "Quota Full",
		"PS_Termination Code": "QF",
		"PS_QuotaFull Reason": "Reached max respondents",
		"Gender": "Male",
		"Gender Code": 1,
		"Age": 35,
		"Income": 50000,
		"Race": "White",
		"Race Code": 1,
		"Race/Ethnicity": "Non-Hispanic",
		"Race/Ethnicity Code": 1,
		"HispanicOrigin": "No",
		"HispanicOrigin Code": 0,
		"Relationship": "Single",
		"Relationship Code": 1,
		"Employment": "Employed",
		"Employment Code": 1,
		"Education": "Bachelor's",
		"Education Code": 2,
		"Device": "Mobile",
		"Device Code": 1,
		"ZipCode": "90210",
		"Children Count": 2,
		"Child1 Age": 5,
		"Child1 Gender": "Female",
		"Child2 Age": 3,
		"Child2 Gender": "Male",
		"Child3 Age": "",
		"Child3 Gender": "",
		"Child4 Age": "",
		"Child4 Gender": "",
		"Child5 Age": "",
		"Child5 Gender": "",
		"Region": "West",
		"Region Code": 1,
		"Division": "Pacific",
		"Division Code": 1,
		"State": "California",
		"State Code": 6,
		"Browser": "Chrome",
		"UserAgent": "Mozilla/5.0",
		"IP": "192.168.1.1",
		"Programmatic Direct Transaction": true,
		"Buyer PM": "Jane Smith",
		"Reconciliation By": "Admin",
		"Respondent Substatus Description": "Verified",
		"Modular Transaction": false
	}
]
🟠403Forbidden
Modified at 2025-10-05 17:17:56
Previous
Get transaction info (V3)
Next
Reconciliation