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

# Update respondent status

> Set a respondent's status from your server.

Sets a respondent's status from your server. Also used to scrub a complete.

Keep sending respondents to your [redirect URLs](https://docs.emporiaresearch.com/demand-api/create-project.md#redirect-urls) as usual. If you've already set their status here, the redirect won't change it. Repeating the same status changes nothing.

## Path parameters

**id** `string` *required*

Project ID.

**respondentId** `string` *required*

Respondent ID.

## Body

**status** `string` *required*

`COMPLETED` or `TERMINATED`.

**statusReason** `string`

Required with `TERMINATED`, not allowed otherwise. See [Statuses](https://docs.emporiaresearch.com/demand-api/list-respondents.md#statuses).

## Scrubbing completes

To remove a bad complete, set `TERMINATED` with `SCRUBBED`. You can scrub within 10 business days of the complete, unless the project is `CLOSED`. Scrubbed respondents aren't billed.

## Response

Returns the updated respondent.

## Errors

General errors are listed in the [Overview](https://docs.emporiaresearch.com/demand-api/overview.md#errors).

| Status | Code | When |
| - | - | - |
| 400 | `INVALID_STATUS` | `status` isn't `COMPLETED` or `TERMINATED`. |
| 400 | `INVALID_STATUS_REASON` | `statusReason` is missing or invalid with `TERMINATED`, or sent with `COMPLETED`. |
| 404 | `PROJECT_NOT_FOUND` | No project with this ID exists for your account. |
| 404 | `RESPONDENT_NOT_FOUND` | No respondent with this ID on this project. |
| 409 | `INVALID_RESPONDENT_STATUS` | The respondent already has a different final status. |
| 409 | `OUTSIDE_WINDOW` | Scrubbing a complete more than 10 business days old. |
| 409 | `PROJECT_CLOSED` | Scrubbing on a `CLOSED` project. |

```json Body theme={null}
{
  "status": "TERMINATED",
  "statusReason": "QUOTA_FULL"
}
```

```json 200 theme={null}
{
  "id": "4e7a1c9b2d5f4a8e9b3c6d1f7a2e5b8c",
  "status": "TERMINATED",
  "statusReason": "QUOTA_FULL",
  "profile": {
    "jobTitle": "Director of Security Operations",
    "industry": "HEALTHCARE",
    "employeeRange": "FIFTY_ONE_TO_FIVE_HUNDRED",
    "country": "US"
  },
  "startedAt": "2026-10-28T09:02:10.118204Z"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.