---
title: "Changes status for a list of cases"
method: POST
path: "/cases/batchStatusChange"
tags: ["Case"]
---

# Changes status for a list of cases

`POST /cases/batchStatusChange`

## Request

- Base URL: `http://localhost:3000/api`
- URL: `http://localhost:3000/api/cases/batchStatusChange`
- Auth: none declared

## Request body

- union
  - object
    - `caseIds` string[], required: Cases having IDs provided here will have their status changed to one specified in status field.
    - `status` 'UNVERIFIED' | 'VERIFIED' | 'EXCLUDED', required
    - `query` string: Cases matching this query will have their status changed. Must contain non-whitespace characters.
    - `note` string: The reason behind exclusion (or other important info). This field is ignored if a status is not "Excluded".
    - `curator` Curator: The logged-in user who submitted the case.
      - `email` string, email
  - object
    - `caseIds` string[]: Cases having IDs provided here will have their status changed to one specified in status field.
    - `status` 'UNVERIFIED' | 'VERIFIED' | 'EXCLUDED', required
    - `query` string, required: Cases matching this query will have their status changed. Must contain non-whitespace characters.
    - `note` string: The reason behind exclusion (or other important info). This field is ignored if a status is not "Excluded".
    - `curator` Curator: The logged-in user who submitted the case.
      - `email` string, email

## Response `200`

OK

## Other responses

- `400`: Malformed request
- `422`: Unprocessable entity
- `500`: Internal server error

## Changes

- **2026-07-17** `886deae8a6f9`: 2 info
  - added the media type `application/json` for the response with the status `400`
  - added the media type `application/json` for the response with the status `422`
- **2020-12-11** `84a0919e1013`: 3 breaking, 6 info
  - removed the enum value `Excluded` of the request property `status`
  - removed the enum value `Unverified` of the request property `status`
  - removed the enum value `Verified` of the request property `status`
  - added the new optional request property `query`
  - …5 more
- **2020-12-11** `71c331b506f1`: 1 info
  - endpoint added
- **2020-09-09** `a14b106f1592`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/globaldothealth/apis/global-health-data-service/changes/cases/batchStatusChange/post.md)

---

[API](https://skmtc.dev/globaldothealth/apis/global-health-data-service.md) - [All operations](https://skmtc.dev/globaldothealth/apis/global-health-data-service/llms.txt) - [OpenAPI document](https://skmtc.dev/globaldothealth/apis/global-health-data-service/revisions/886deae8a6f9?raw)