---
title: "Changes to Get a virus data report by taxon"
method: GET
path: "/virus/taxon/{taxon}/dataset_report"
---

# Changes to Get a virus data report by taxon

`GET /virus/taxon/{taxon}/dataset_report`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 13 revisions.

- **2025-05-08** `6b24249801ec`: 1 breaking, 6 info
- **2025-04-28** `f08be9b66e16`: 1 breaking, 8 info
- **2025-02-08** `00bdccfc6283`: 1 breaking, 4 warning, 4 info
- **2023-11-14** `b4da81b65e0a`: 1 info

## Changes

- **2025-05-08** `6b24249801ec`: 1 breaking, 6 info
  - for the `query` request parameter `returned_content`, default value `COMPLETE` was added
  - the `completeness` response's property default value `UNKNOWN` was added for the status `200` (media type: application/json)
  - the `completeness` response's property default value `UNKNOWN` was added for the status `200` (media type: application/x-ndjson)
  - the `orientation` response's property default value `none` was added for the status `200` (media type: application/json)
  - the `orientation` response's property default value `none` was added for the status `200` (media type: application/x-ndjson)
  - the `purpose_of_sampling` response's property default value `PURPOSE_OF_SAMPLING_UNKNOWN` was added for the status `200` (media type: application/json)
  - the `purpose_of_sampling` response's property default value `PURPOSE_OF_SAMPLING_UNKNOWN` was added for the status `200` (media type: application/x-ndjson)
- **2025-04-28** `f08be9b66e16`: 1 breaking, 8 info
  - for the `query` request parameter `returned_content`, default value `COMPLETE` was removed
  - added the optional property `reports/items/segment` to the response with the `200` status (media type: application/json)
  - added the optional property `reports/items/segment` to the response with the `200` status (media type: application/x-ndjson)
  - the `completeness` response's property default value `UNKNOWN` was removed for the status `200` (media type: application/json)
  - the `completeness` response's property default value `UNKNOWN` was removed for the status `200` (media type: application/x-ndjson)
  - the `orientation` response's property default value `none` was removed for the status `200` (media type: application/json)
  - the `orientation` response's property default value `none` was removed for the status `200` (media type: application/x-ndjson)
  - the `purpose_of_sampling` response's property default value `PURPOSE_OF_SAMPLING_UNKNOWN` was removed for the status `200` (media type: application/json)
  - the `purpose_of_sampling` response's property default value `PURPOSE_OF_SAMPLING_UNKNOWN` was removed for the status `200` (media type: application/x-ndjson)
- **2025-02-08** `00bdccfc6283`: 1 breaking, 4 warning, 4 info
  - removed the media type `application/json` for the response with the status `default`
  - removed the optional property `_first_page` from the response with the `200` status
  - removed the optional property `_report_fields` from the response with the `200` status
  - removed the optional property `_report_format` from the response with the `200` status
  - removed the optional property `_report_type` from the response with the `200` status
  - added the new optional `query` request parameter `filter.usa_state`
  - added the media type `application/x-ndjson` for the response with the status `200`
  - added the media type `text/plain` for the response with the status `default`
  - added the optional property `reports/items/location/usa_state` to the response with the `200` status
- **2023-11-14** `b4da81b65e0a`: 1 info
  - added the optional property `_report_format` to the response with the `200` status

---

[Operation](https://skmtc.dev/ncats/apis/ncbi-datasets-api/docs/virus/taxon/:taxon/dataset_report/get.md) - [API](https://skmtc.dev/ncats/apis/ncbi-datasets-api.md) - [Page](https://skmtc.dev/ncats/apis/ncbi-datasets-api/changes/virus/taxon/:taxon/dataset_report/get)