> ## Documentation Index
> Fetch the complete documentation index at: https://docs.repdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Respondent Status Codes

> inbound_code values on survey redirects, isc sub-codes, and how GET /responses maps them to named statuses.

Survey redirects returned by `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 these `inbound_code` values on your survey platform return URLs (included on the survey object as `redirects`):

| Redirect              | inbound\_code | Required   |
| --------------------- | ------------- | ---------- |
| Complete              | `1000`        | Yes        |
| Standard termination  | `2000`        | Yes        |
| Quality termination   | `1`           | Encouraged |
| Security termination  | `3000`        | Encouraged |
| Overquota termination | `4000`        | Encouraged |

See [Implementing Redirect Links](/demand/guides/04-managing-surveys#implementing-redirect-links).

<Note>
  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.
</Note>

## Named statuses on GET /responses

`GET /responses` maps a subset of codes to named `status` values you can filter with the `statuses` query parameter:

| status                | inbound\_code / isc               |
| --------------------- | --------------------------------- |
| Complete              | `inbound_code=1000`               |
| Standard Termination  | `inbound_code=2000`               |
| Quality Termination   | `isc=5002`                        |
| Security Termination  | `inbound_code=3000` or `isc=5101` |
| Overquota Termination | `inbound_code=4000`               |

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:

| Field          | Where it appears                                                                     | What it means                                                              |
| -------------- | ------------------------------------------------------------------------------------ | -------------------------------------------------------------------------- |
| `inbound_code` | Client redirect URLs (`rdsecured.com/return`), traffic reports, Demand API responses | High-level outcome family (complete, term, security, over-quota, Defender) |
| `isc`          | Supplier callback links, traffic reports                                             | Specific reason within that family                                         |

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

| inbound\_code | Definition                | Assigned by     | Supplier redirect |
| ------------- | ------------------------- | --------------- | ----------------- |
| `1`           | RDefender Term            | Research Desk   | Security          |
| `1000`        | Complete                  | Client redirect | Complete          |
| `2000`        | Term                      | Client redirect | Term              |
| `3000`        | Client-Side Security Term | Client redirect | Security          |
| `4000`        | Client-Side Overquota     | Client redirect | OQ                |
| `5000`        | Research Desk Term        | Research Desk   | Term              |
| `6000`        | Research Desk Overquota   | Research Desk   | OQ                |

## isc reference

### inbound\_code `1` — Research Defender Term

Respondent did **not** reach the client survey. Redirected to the **Security** supplier link.

| isc | Definition                                                      |
| --- | --------------------------------------------------------------- |
| `2` | Failed on Research Defender SEARCH module                       |
| `3` | Failed on Research Defender ACTIVITY module                     |
| `4` | Failed on Research Defender REVIEW module                       |
| `5` | Failed on Research Defender Complete module                     |
| `6` | Failed on Research Defender SEARCH — higher CPI / higher threat |
| `8` | Failed on Research Defender REVIEW — not contextually correct   |

### inbound\_code `1000` — Complete

Respondent reached the client survey. Redirected to the **Complete** supplier link.

| isc    | Definition |
| ------ | ---------- |
| `1000` | Complete   |

### inbound\_code `2000` — Term

Respondent reached the client survey. Redirected to the **Term** supplier link.

| isc    | Definition                                           |
| ------ | ---------------------------------------------------- |
| `2000` | Client-side term (for example, a screening question) |

### inbound\_code `3000` — Client-Side Security Term

Respondent reached the client survey. Redirected to the **Security** supplier link.

| isc    | Definition                        |
| ------ | --------------------------------- |
| `3000` | Survey quality term (client side) |

### inbound\_code `4000` — Client-Side Overquota

Respondent reached the client survey. Redirected to the **OQ** supplier link.

| isc    | Definition                      |
| ------ | ------------------------------- |
| `4000` | General overquota (client side) |

### inbound\_code `5000` — Research Desk Term

Assigned by Research Desk. Redirected to the **Term** supplier link.

| isc    | Definition                                                                             | Reached client survey |
| ------ | -------------------------------------------------------------------------------------- | --------------------- |
| `5001` | Stream closed (Research Desk)                                                          | No                    |
| `5003` | Qualification mismatch. `TermedQualificationID` is appended on the supplier term link. | No                    |
| `5004` | Device compatibility mismatch                                                          | No                    |
| `5005` | Invalid L2 voter match                                                                 | No                    |
| `5006` | Suspicious device (bot-like detection)                                                 | No                    |
| `5007` | Sample group exclusion term                                                            | No                    |
| `5008` | Respondent list mismatch (recontacts / inclusions)                                     | No                    |
| `5009` | Qualification verification mismatch                                                    | No                    |
| `5101` | Attempted bypass of client survey                                                      | No                    |
| `5102` | Encryption failure (hashing)                                                           | Yes                   |
| `5103` | Speeder term (under 30 seconds or under 20% of LOI)                                    | Yes                   |
| `5104` | Suspicious re-entry attempt                                                            | Yes                   |

### inbound\_code `6000` — Research Desk Overquota

Assigned by Research Desk. Respondent did **not** reach the client survey. Redirected to the **OQ** supplier link.

| isc    | Definition                                                                                       |
| ------ | ------------------------------------------------------------------------------------------------ |
| `6001` | Overall quota achieved (Research Desk)                                                           |
| `6002` | Sub-quota achieved (Research Desk). `TermedQuotaID` is appended on the supplier over-quota link. |
| `6003` | In-survey maximum exceeded (Research Desk)                                                       |

## Related pages

* [Environments & Status Codes](/demand/overview/01-environments-and-status-codes) — HTTP status codes and environment URLs
* [Managing Respondents](/demand/guides/05-managing-respondents)
* [GET /responses](/demand/endpoints/13-get-responses)
