---
title: "Changes to Streams a CSV, TSV or JSON attachment of cases matching the search query.  If caseIds are supplied the CSV only contains cases with those ids.  You cannot supply both query and caseIds."
method: POST
path: "/cases/download"
---

# Changes to Streams a CSV, TSV or JSON attachment of cases matching the search query.  If caseIds are supplied the CSV only contains cases with those ids.  You cannot supply both query and caseIds.

`POST /cases/download`

> Every recorded change to this operation, newest first.
> 70 revisions in range; 19 not diffed.

## Timeline

Changed in 5 of 70 revisions.

- **2026-07-17** `886deae8a6f9`: 2 info
- **2021-06-08** `47196f12b6d8`: 1 breaking, 2 info
- **2021-06-08** `7453480b119d`: 1 breaking, 2 info
- **2020-09-21** `5c7a917caf1c`: 1 info
- **2020-09-09** `a14b106f1592`: 1 info

## Changes

- **2026-07-17** `886deae8a6f9`: 2 info
  - added the non-success response with the status `400`
  - added the non-success response with the status `422`
- **2021-06-08** `47196f12b6d8`: 1 breaking, 2 info
  - the request's body type changed from `object` to no type
  - added the new optional request property `format`
  - added the new optional request property `limit`
- **2021-06-08** `7453480b119d`: 1 breaking, 2 info
  - the request's body type changed from `object` to no type
  - added the new optional request property `format`
  - added the new optional request property `limit`
- **2020-09-21** `5c7a917caf1c`: 1 info
  - removed the pattern `\S+` from the request property `query`
- **2020-09-09** `a14b106f1592`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/globaldothealth/apis/global-health-data-service/docs/cases/download/post.md) - [API](https://skmtc.dev/globaldothealth/apis/global-health-data-service.md) - [Page](https://skmtc.dev/globaldothealth/apis/global-health-data-service/changes/cases/download/post)