---
title: "Changes to Get a filtered taxonomic subtree by taxon"
method: POST
path: "/taxonomy/filtered_subtree"
---

# Changes to Get a filtered taxonomic subtree by taxon

`POST /taxonomy/filtered_subtree`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 13 revisions.

- **2026-08-06** `e5d4400c8e5d`: 11 info
- **2025-09-29** `e17d9b32b6e0`: 2 warning, 1 info
- **2025-05-08** `6b24249801ec`: 9 info
- **2025-04-28** `f08be9b66e16`: 13 info
- **2025-02-08** `00bdccfc6283`: 1 breaking, 5 warning, 3 info
- **2023-11-14** `b4da81b65e0a`: 5 warning

## Changes

- **2026-08-06** `e5d4400c8e5d`: 11 info
  - added the new optional request property `exclude_extinct`
  - added the new optional request property `levels`
  - added the optional property `edges/additionalProperties/assembly_count` to the response with the `200` status
  - added the optional property `edges/additionalProperties/curator_common_name` to the response with the `200` status
  - added the optional property `edges/additionalProperties/rank` to the response with the `200` status
  - added the optional property `edges/additionalProperties/scientific_name` to the response with the `200` status
  - added the optional property `edges/default/assembly_count` to the response with the `200` status
  - added the optional property `edges/default/curator_common_name` to the response with the `200` status
  - added the optional property `edges/default/rank` to the response with the `200` status
  - added the optional property `edges/default/scientific_name` to the response with the `200` status
  - added the optional property `errors/items/sequence_error_code` to the response with the `200` status
- **2025-09-29** `e17d9b32b6e0`: 2 warning, 1 info
  - added the new `ONLY_UNSPECIFIED_CHILDREN` enum value to the `edges/additionalProperties/children_status` response property for the response status `200`
  - added the new `ONLY_UNSPECIFIED_CHILDREN` enum value to the `edges/default/children_status` response property for the response status `200`
  - added the new optional request property `include_incertae_sedis`
- **2025-05-08** `6b24249801ec`: 9 info
  - the `` request property default value `NO_RANK` was added
  - the `assembly_error_code` response's property default value `UNKNOWN_ASSEMBLY_ERROR_CODE` was added for the status `200`
  - the `children_status` response's property default value `UNSPECIFIED` was added for the status `200`
  - the `children_status` response's property default value `UNSPECIFIED` was added for the status `200`
  - the `gene_error_code` response's property default value `UNKNOWN_GENE_ERROR_CODE` was added for the status `200`
  - the `gene_warning_code` response's property default value `UNKNOWN_GENE_WARNING_CODE` was added for the status `200`
  - the `organelle_error_code` response's property default value `UNKNOWN_ORGANELLE_ERROR_CODE` was added for the status `200`
  - the `taxonomy_error_code` response's property default value `UNKNOWN_TAXONOMY_ERROR_CODE` was added for the status `200`
  - the `virus_error_code` response's property default value `UNKNOWN_VIRUS_ERROR_CODE` was added for the status `200`
- **2025-04-28** `f08be9b66e16`: 13 info
  - the `` request property default value `NO_RANK` was removed
  - added the new `ACELLULAR_ROOT` enum value to the request property `rank_limits/items/`
  - added the new `CELLULAR_ROOT` enum value to the request property `rank_limits/items/`
  - added the new `DOMAIN` enum value to the request property `rank_limits/items/`
  - added the new `REALM` enum value to the request property `rank_limits/items/`
  - the `assembly_error_code` response's property default value `UNKNOWN_ASSEMBLY_ERROR_CODE` was removed for the status `200`
  - the `children_status` response's property default value `UNSPECIFIED` was removed for the status `200`
  - the `children_status` response's property default value `UNSPECIFIED` was removed for the status `200`
  - the `gene_error_code` response's property default value `UNKNOWN_GENE_ERROR_CODE` was removed for the status `200`
  - the `gene_warning_code` response's property default value `UNKNOWN_GENE_WARNING_CODE` was removed for the status `200`
  - the `organelle_error_code` response's property default value `UNKNOWN_ORGANELLE_ERROR_CODE` was removed for the status `200`
  - the `taxonomy_error_code` response's property default value `UNKNOWN_TAXONOMY_ERROR_CODE` was removed for the status `200`
  - the `virus_error_code` response's property default value `UNKNOWN_VIRUS_ERROR_CODE` was removed for the status `200`
- **2025-02-08** `00bdccfc6283`: 1 breaking, 5 warning, 3 info
  - removed the media type `application/json` for the response with the status `default`
  - added the new `INVALID_BIOSAMPLE_IDS` enum value to the `errors/items/assembly_error_code` response property for the response status `200`
  - added the new `INVALID_WGS_ACCESSIONS` enum value to the `errors/items/assembly_error_code` response property for the response status `200`
  - added the new `NO_ASSEMBLIES_FOR_ASSEMBLY_NAMES` enum value to the `errors/items/assembly_error_code` response property for the response status `200`
  - added the new `NO_ASSEMBLIES_FOR_BIOSAMPLE_IDS` enum value to the `errors/items/assembly_error_code` response property for the response status `200`
  - added the new `NO_ASSEMBLIES_FOR_WGS_ACCESSIONS` enum value to the `errors/items/assembly_error_code` response property for the response status `200`
  - added the media type `text/plain` for the response with the status `default`
  - added the optional property `errors/items/organelle_error_code` to the response with the `200` status
  - added the optional property `errors/items/taxonomy_error_code` to the response with the `200` status
- **2023-11-14** `b4da81b65e0a`: 5 warning
  - removed the optional property `errors/items/valid_identifiers` from the response with the `200` status
  - added the new `ABOVE_SPECIES_TAXON` enum value to the `warnings/items/gene_warning_code` response property for the response status `200`
  - added the new `INVALID_TAXON_GENE_ARGUMENT` enum value to the `errors/items/gene_error_code` response property for the response status `200`
  - added the new `MISSING_SEARCH_FIELD` enum value to the `errors/items/assembly_error_code` response property for the response status `200`
  - added the new `NO_GENE_ANNOTATION_FOUND` enum value to the `warnings/items/gene_warning_code` response property for the response status `200`

---

[Operation](https://skmtc.dev/ncats/apis/ncbi-datasets-api/docs/taxonomy/filtered_subtree/post.md) - [API](https://skmtc.dev/ncats/apis/ncbi-datasets-api.md) - [Page](https://skmtc.dev/ncats/apis/ncbi-datasets-api/changes/taxonomy/filtered_subtree/post)