---
title: "Changes to Lists cases"
method: GET
path: "/cases"
---

# Changes to Lists cases

`GET /cases`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 24 of 50 revisions.

- **2026-07-17** `886deae8a6f9`: 2 info
- **2022-04-29** `e11f54229b64`: 2 warning
- **2022-01-06** `875e892119b9`: 1 info
- **2021-12-13** `b3a1a3769a09`: 2 breaking, 2 info
- **2021-10-13** `10817d9f027f`: 1 breaking, 8 warning, 3 info
- **2021-09-30** `cc928775a6cd`: 1 info
- **2021-07-23** `9ccd147a4041`: 1 info
- **2021-06-08** `c3c5d3d110a7`: 1 breaking
- **2021-06-08** `ddb7e71bd405`: 1 info
- **2021-06-08** `ada64414e2a1`: 2 breaking, 7 warning
- **2021-06-08** `7453480b119d`: 2 warning, 9 info
- **2021-04-23** `74bc16896f4c`: 1 breaking
- **2021-04-23** `1723bd594a52`: 2 breaking, 1 info
- **2021-04-23** `833862135d37`: 1 info
- **2021-03-25** `fa0c80f3026a`: 1 breaking, 9 info
- **2021-03-25** `b7fec0c0a304`: 2 breaking, 9 warning
- **2021-03-11** `8bf8c1861259`: 1 breaking
- **2021-03-11** `ba42242be44f`: 1 info
- **2021-02-04** `894104a9ac72`: 1 info
- **2020-12-11** `0539b5bd93f9`: 1 warning
- **2020-09-24** `c6971ce94867`: 2 info
- **2020-09-17** `155e084b2859`: 2 warning
- **2020-09-17** `8e843a4b126e`: 2 info
- **2020-09-09** `a14b106f1592`: 6 breaking, 7 warning, 10 info

## 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`
- **2022-04-29** `e11f54229b64`: 2 warning
  - removed the optional property `cases/items/notes` from the response with the `200` status
  - removed the optional property `cases/items/restrictedNotes` from the response with the `200` status
- **2022-01-06** `875e892119b9`: 1 info
  - added the optional property `cases/items/SGTF` to the response with the `200` status
- **2021-12-13** `b3a1a3769a09`: 2 breaking, 2 info
  - for the `query` request parameter `order`, default value `1` was removed
  - for the `query` request parameter `sort_by`, default value `0` was removed
  - for the `query` request parameter `order`, the type was generalized from `integer` to `string`
  - for the `query` request parameter `sort_by`, the type was generalized from `integer` to `string`
- **2021-10-13** `10817d9f027f`: 1 breaking, 8 warning, 3 info
  - the `cases/items/vaccines/items/` response's property type changed from `object` to no type for status `200`
  - removed the optional property `cases/items/vaccines/items/administrativeAreaLevel1` from the response with the `200` status
  - removed the optional property `cases/items/vaccines/items/administrativeAreaLevel2` from the response with the `200` status
  - removed the optional property `cases/items/vaccines/items/administrativeAreaLevel3` from the response with the `200` status
  - removed the optional property `cases/items/vaccines/items/country` from the response with the `200` status
  - removed the optional property `cases/items/vaccines/items/geoResolution` from the response with the `200` status
  - removed the optional property `cases/items/vaccines/items/geometry` from the response with the `200` status
  - removed the optional property `cases/items/vaccines/items/place` from the response with the `200` status
  - removed the optional property `cases/items/vaccines/items/query` from the response with the `200` status
  - added the optional property `cases/items/vaccines/items/batch` to the response with the `200` status
  - added the optional property `cases/items/vaccines/items/date` to the response with the `200` status
  - added the optional property `cases/items/vaccines/items/sideEffects` to the response with the `200` status
- **2021-09-30** `cc928775a6cd`: 1 info
  - added the optional property `cases/items/vaccines` to the response with the `200` status
- **2021-07-23** `9ccd147a4041`: 1 info
  - added the optional property `cases/items/restrictedNotes` to the response with the `200` status
- **2021-06-08** `c3c5d3d110a7`: 1 breaking
  - for the `query` request parameter `count_limit`, the min was increased from `1.00` to `100.00`
- **2021-06-08** `ddb7e71bd405`: 1 info
  - for the `query` request parameter `count_limit`, the min was decreased from `100.00` to `1.00`
- **2021-06-08** `ada64414e2a1`: 2 breaking, 7 warning
  - the response property `cases/items/travelHistory/travel/items/location/geometry/latitude` became optional for the status `200`
  - the response property `cases/items/travelHistory/travel/items/location/geometry/longitude` became optional for the status `200`
  - removed the optional property `cases/items/travelHistory/travel/items/location/query` from the response with the `200` status
  - added the new `Admin1` enum value to the `cases/items/travelHistory/travel/items/location/geoResolution` response property for the response status `200`
  - added the new `Admin2` enum value to the `cases/items/travelHistory/travel/items/location/geoResolution` response property for the response status `200`
  - added the new `Admin3` enum value to the `cases/items/travelHistory/travel/items/location/geoResolution` response property for the response status `200`
  - added the new `Country` enum value to the `cases/items/travelHistory/travel/items/location/geoResolution` response property for the response status `200`
  - added the new `Point` enum value to the `cases/items/travelHistory/travel/items/location/geoResolution` response property for the response status `200`
  - added the new `undefined` enum value to the `cases/items/travelHistory/travel/items/location/geoResolution` response property for the response status `200`
- **2021-06-08** `7453480b119d`: 2 warning, 9 info
  - deleted the `query` request parameter `order`
  - deleted the `query` request parameter `sort_by`
  - added the optional property `cases/items/travelHistory/travel/items/location/query` to the response with the `200` status
  - the response property `cases/items/travelHistory/travel/items/location/geometry/latitude` became required for the status `200`
  - the response property `cases/items/travelHistory/travel/items/location/geometry/longitude` became required for the status `200`
  - removed the `Admin1` enum value from the `cases/items/travelHistory/travel/items/location/geoResolution` response property for the response status `200`
  - removed the `Admin2` enum value from the `cases/items/travelHistory/travel/items/location/geoResolution` response property for the response status `200`
  - removed the `Admin3` enum value from the `cases/items/travelHistory/travel/items/location/geoResolution` response property for the response status `200`
  - removed the `Country` enum value from the `cases/items/travelHistory/travel/items/location/geoResolution` response property for the response status `200`
  - removed the `Point` enum value from the `cases/items/travelHistory/travel/items/location/geoResolution` response property for the response status `200`
  - removed the `undefined` enum value from the `cases/items/travelHistory/travel/items/location/geoResolution` response property for the response status `200`
- **2021-04-23** `74bc16896f4c`: 1 breaking
  - for the `query` request parameter `order`, default value was changed from `0` to `1`
- **2021-04-23** `1723bd594a52`: 2 breaking, 1 info
  - for the `query` request parameter `sort_by`, default value `0` was added
  - for the `query` request parameter `sort_by`, the type changed from `string` to `integer`
  - added the new optional `query` request parameter `order`
- **2021-04-23** `833862135d37`: 1 info
  - added the new optional `query` request parameter `sort_by`
- **2021-03-25** `fa0c80f3026a`: 1 breaking, 9 info
  - the `cases/items/travelHistory/travel/items/location` response's property type changed from no type to `object` for status `200`
  - added the optional property `cases/items/travelHistory/travel/items/location/administrativeAreaLevel1` to the response with the `200` status
  - added the optional property `cases/items/travelHistory/travel/items/location/administrativeAreaLevel2` to the response with the `200` status
  - added the optional property `cases/items/travelHistory/travel/items/location/administrativeAreaLevel3` to the response with the `200` status
  - added the optional property `cases/items/travelHistory/travel/items/location/country` to the response with the `200` status
  - added the optional property `cases/items/travelHistory/travel/items/location/geoResolution` to the response with the `200` status
  - added the optional property `cases/items/travelHistory/travel/items/location/geometry` to the response with the `200` status
  - added the optional property `cases/items/travelHistory/travel/items/location/name` to the response with the `200` status
  - added the optional property `cases/items/travelHistory/travel/items/location/place` to the response with the `200` status
  - removed `#/components/schemas/Location, subschema #2` from the `cases/items/travelHistory/travel/items/location` response property `oneOf` list for the response status `200`
- **2021-03-25** `b7fec0c0a304`: 2 breaking, 9 warning
  - added `#/components/schemas/Location, subschema #2` to the `cases/items/travelHistory/travel/items/location` response property `oneOf` list for the response status `200`
  - the `cases/items/travelHistory/travel/items/location` response's property type changed from `object` to no type for status `200`
  - removed the optional property `cases/items/travelHistory/travel/items/location/administrativeAreaLevel1` from the response with the `200` status
  - removed the optional property `cases/items/travelHistory/travel/items/location/administrativeAreaLevel2` from the response with the `200` status
  - removed the optional property `cases/items/travelHistory/travel/items/location/administrativeAreaLevel3` from the response with the `200` status
  - removed the optional property `cases/items/travelHistory/travel/items/location/country` from the response with the `200` status
  - removed the optional property `cases/items/travelHistory/travel/items/location/geoResolution` from the response with the `200` status
  - removed the optional property `cases/items/travelHistory/travel/items/location/geometry` from the response with the `200` status
  - removed the optional property `cases/items/travelHistory/travel/items/location/name` from the response with the `200` status
  - removed the optional property `cases/items/travelHistory/travel/items/location/place` from the response with the `200` status
  - removed the optional property `cases/items/travelHistory/travel/items/location/query` from the response with the `200` status
- **2021-03-11** `8bf8c1861259`: 1 breaking
  - for the `query` request parameter `count_limit`, default value `10000` was added
- **2021-03-11** `ba42242be44f`: 1 info
  - added the new optional `query` request parameter `count_limit`
- **2021-02-04** `894104a9ac72`: 1 info
  - added the optional property `cases/items/variant` to the response with the `200` status
- **2020-12-11** `0539b5bd93f9`: 1 warning
  - added the new `EXCLUDED` enum value to the `cases/items/caseReference/verificationStatus` response property for the response status `200`
- **2020-09-24** `c6971ce94867`: 2 info
  - added the optional property `cases/items/location/query` to the response with the `200` status
  - added the optional property `cases/items/travelHistory/travel/items/location/query` to the response with the `200` status
- **2020-09-17** `155e084b2859`: 2 warning
  - removed the optional property `cases/items/location/query` from the response with the `200` status
  - removed the optional property `cases/items/travelHistory/travel/items/location/query` from the response with the `200` status
- **2020-09-17** `8e843a4b126e`: 2 info
  - added the optional property `cases/items/location/query` to the response with the `200` status
  - added the optional property `cases/items/travelHistory/travel/items/location/query` to the response with the `200` status
- **2020-09-09** `a14b106f1592`: 6 breaking, 7 warning, 10 info
  - removed the media type `application/json` for the response with the status `400`
  - removed the media type `application/json` for the response with the status `422`
  - the `cases/items/location/country` response property's maxLength was unset from `2` for the response status `200`
  - the `cases/items/travelHistory/travel/items/location/country` response property's maxLength was unset from `2` for the response status `200`
  - the `cases/items/location/country` response property's minLength was decreased from `2` to `0` for the response status `200`
  - the `cases/items/travelHistory/travel/items/location/country` response property's minLength was decreased from `2` to `0` for the response status `200`
  - deleted the `query` request parameter `count_limit`
  - deleted the `query` request parameter `order`
  - deleted the `query` request parameter `sort_by`
  - removed the optional property `cases/items/SGTF` from the response with the `200` status
  - removed the optional property `cases/items/location/query` from the response with the `200` status
  - removed the optional property `cases/items/vaccines` from the response with the `200` status
  - removed the optional property `cases/items/variant` from the response with the `200` status
  - added the optional property `cases/items/notes` to the response with the `200` status
  - the response property `cases/items/travelHistory/travel/items/location/geometry/latitude` became required for the status `200`
  - the response property `cases/items/travelHistory/travel/items/location/geometry/longitude` became required for the status `200`
  - removed the `Admin1` enum value from the `cases/items/travelHistory/travel/items/location/geoResolution` response property for the response status `200`
  - removed the `Admin2` enum value from the `cases/items/travelHistory/travel/items/location/geoResolution` response property for the response status `200`
  - removed the `Admin3` enum value from the `cases/items/travelHistory/travel/items/location/geoResolution` response property for the response status `200`
  - removed the `Country` enum value from the `cases/items/travelHistory/travel/items/location/geoResolution` response property for the response status `200`
  - removed the `EXCLUDED` enum value from the `cases/items/caseReference/verificationStatus` response property for the response status `200`
  - removed the `Point` enum value from the `cases/items/travelHistory/travel/items/location/geoResolution` response property for the response status `200`
  - removed the `undefined` enum value from the `cases/items/travelHistory/travel/items/location/geoResolution` response property for the response status `200`

---

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