POST /surveys include an inbound_code that tells Research Desk the respondent’s outcome. Research Desk also assigns Desk-side codes when it terms or over-quotas a respondent itself. The more specific isc (internal status code) is what suppliers receive on callback links and what appears in traffic reports.
Client redirect codes
Program theseinbound_code values on your survey platform return URLs (included on the survey object as redirects):
See Implementing Redirect Links.
The quality-termination redirect uses
inbound_code=1, the same family Research Desk uses for Defender terms. Client quality terms occur after the respondent reached your survey; Defender isc values 2–8 occur before entry.Named statuses on GET /responses
GET /responses maps a subset of codes to named status values you can filter with the statuses query parameter:
Other isc values in the reference below still appear on respondent records and in traffic reports even when they are not returned as one of these named statuses.
Research Desk records two related values for every respondent session:
Client survey platforms program client-side
inbound_code values on return redirects (1000, 2000, 3000, 4000). Research Desk assigns Desk-side codes (1, 5000, 6000) when it terms or over-quotas a respondent before or during the session. The isc is always returned on the supplier callback link.
An Abandon is recorded when no recognized redirect fires. It is not an inbound_code.
Code families
isc reference
inbound_code 1 — Research Defender Term
Respondent did not reach the client survey. Redirected to the Security supplier link.
inbound_code 1000 — Complete
Respondent reached the client survey. Redirected to the Complete supplier link.
inbound_code 2000 — Term
Respondent reached the client survey. Redirected to the Term supplier link.
inbound_code 3000 — Client-Side Security Term
Respondent reached the client survey. Redirected to the Security supplier link.
inbound_code 4000 — Client-Side Overquota
Respondent reached the client survey. Redirected to the OQ supplier link.
inbound_code 5000 — Research Desk Term
Assigned by Research Desk. Redirected to the Term supplier link.
inbound_code 6000 — Research Desk Overquota
Assigned by Research Desk. Respondent did not reach the client survey. Redirected to the OQ supplier link.
Related pages
- Environments & Status Codes — HTTP status codes and environment URLs
- Managing Respondents
- GET /responses