Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Request Parameter

Type

Description 

Example

st

integer - enum (17, 18, 20, 21, 30)

This is the PureSpectrum status code. Pass in the appropriate code corresponding to your desired status.

17 - OverQuota

18 - Termination

20 - Quality Termination

21 - Complete

30 - Dedupe

st=21

quota_id

string - comma separated values

This is the identifier of the quotas for which the respondent has qualified for.

abc123

Sample Request: 

Code Block
languagejs
POST /buyers/v2/surveys/:surveyId/transactions/transaction_id/status?st=21&quota_id=1,2,3

Response:

Response Code:

200

Response Body:

Code Block
[]

Other examples:

  • Once the survey respondent status is passed as “complete” through /surveydone endpoint, it is the final status of that transaction id. If tried to update the transaction using /status endpoint again, then it will throw the error as shown in below example -

Response Code:

400

...

Response Body:

js
Code Block
language
{
  	  "ps_error_code": 10011003,
  	  "ps_error_message":"Incorrect "This transaction id already has a final status code"
},

Postman example:

...

Other Error Messages:

Code Block
languagejs
{ 
	"ps_error_code": 10021001,
	"ps_error_message":"InsufficientIncorrect parameters - please check your requeststatus code"
},

{ 
	"ps_error_code": 10031002,
	"ps_error_message":"ThisInsufficient transactionparameters id- alreadyplease hascheck ayour final statusrequest"
},

{ 
  "ps_error_code": 1004,
  "ps_error_message":"Transaction ID Not found.  Please check the survey id and transaction ID and try again."
},

{
  "ps_error_code": 1005,
  "ps_error_message":"Invalid or missing QLC codes"
}

...