---
title: "Update a respondent's status"
method: POST
path: "/fulfillment/respondents/transition"
tags: ["Fulfillment"]
---

# Update a respondent's status

`POST /fulfillment/respondents/transition`

## Request

- Base URL: `https://s2s.cint.com`
- URL: `https://s2s.cint.com/fulfillment/respondents/transition`
- Auth: none required
- TypeScript: <https://skmtc.dev/cint/apis/demand-api/docs/fulfillment/respondents/transition/post.ts> (a function with typed inputs; its response is checked against the schema)

Updates the respondent's status defined by the status code in the body of the request.

The following table contains the possible codes that can be supplied in the body's `status` field: 

| Cint Status Definition | S2S Code |
| :---- | :---- |
| Complete | **5** |
| Screenout | **2** |
| Quality Terminate | **4** |
| Quota Full | **3** |

## Headers

- `Authorization` string, required

## Request body

- RespondentFillfilmentTransitionRequest: Provides information on the transition request of a respondent's status.
  - `id` string, required: The session ID (RID) of the respondent.
  - `status` integer, required: The status to which the respondent is being transitioned.

## Response `200`

The respondent's status was successfully updated.

- RespondentFillfilmentTransitionResult: Respondent's session status result.
  - `id` string: The session ID (RID) of the respondent whose status was updated.
  - `status` integer: The status to which the session (RID) was updated to.

## Other responses

- `404`: The respondent status could not be found.
- `422`: An error occurred while processing the request.

---

[API](https://skmtc.dev/cint/apis/demand-api.md) - [All operations](https://skmtc.dev/cint/apis/demand-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cint/apis/demand-api/revisions/077a4bdda5cb?raw)