---
title: "Changes to Get taxonomy metadata by taxon"
method: POST
path: "/taxonomy"
---

# Changes to Get taxonomy metadata by taxon

`POST /taxonomy`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 5 of 13 revisions.

- **2026-08-06** `e5d4400c8e5d`: 3 info
- **2025-05-08** `6b24249801ec`: 18 info
- **2025-04-28** `f08be9b66e16`: 4 warning, 22 info
- **2025-02-08** `00bdccfc6283`: 1 breaking, 12 warning, 11 info
- **2023-11-14** `b4da81b65e0a`: 10 warning, 7 info

## Changes

- **2026-08-06** `e5d4400c8e5d`: 3 info
  - endpoint deprecated
  - added the optional property `messages/items/error/sequence_error_code` to the response with the `200` status
  - added the optional property `taxonomy_nodes/items/errors/items/sequence_error_code` to the response with the `200` status
- **2025-05-08** `6b24249801ec`: 18 info
  - the `` request property default value `NO_RANK` was added
  - the `include_tabular_header` request property default value `INCLUDE_TABULAR_HEADER_FIRST_PAGE_ONLY` was added
  - the `returned_content` request property default value `COMPLETE` was added
  - the `table_format` request property default value `SUMMARY` was added
  - the `assembly_error_code` response's property default value `UNKNOWN_ASSEMBLY_ERROR_CODE` was added for the status `200`
  - the `assembly_error_code` response's property default value `UNKNOWN_ASSEMBLY_ERROR_CODE` 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_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 `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 `organelle_error_code` response's property default value `UNKNOWN_ORGANELLE_ERROR_CODE` was added for the status `200`
  - the `rank` response's property default value `NO_RANK` 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 `taxonomy_error_code` response's property default value `UNKNOWN_TAXONOMY_ERROR_CODE` was added for the status `200`
  - the `type` response's property default value `COUNT_TYPE_UNSPECIFIED` 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`
  - the `virus_error_code` response's property default value `UNKNOWN_VIRUS_ERROR_CODE` was added for the status `200`
- **2025-04-28** `f08be9b66e16`: 4 warning, 22 info
  - added the new `ACELLULAR_ROOT` enum value to the `taxonomy_nodes/items/taxonomy/rank` response property for the response status `200`
  - added the new `CELLULAR_ROOT` enum value to the `taxonomy_nodes/items/taxonomy/rank` response property for the response status `200`
  - added the new `DOMAIN` enum value to the `taxonomy_nodes/items/taxonomy/rank` response property for the response status `200`
  - added the new `REALM` enum value to the `taxonomy_nodes/items/taxonomy/rank` response property for the response status `200`
  - the `` request property default value `NO_RANK` was removed
  - the `include_tabular_header` request property default value `INCLUDE_TABULAR_HEADER_FIRST_PAGE_ONLY` was removed
  - the `returned_content` request property default value `COMPLETE` was removed
  - the `table_format` request property default value `SUMMARY` was removed
  - added the new `ACELLULAR_ROOT` enum value to the request property `ranks/items/`
  - added the new `CELLULAR_ROOT` enum value to the request property `ranks/items/`
  - added the new `DOMAIN` enum value to the request property `ranks/items/`
  - added the new `REALM` enum value to the request property `ranks/items/`
  - the `assembly_error_code` response's property default value `UNKNOWN_ASSEMBLY_ERROR_CODE` was removed for the status `200`
  - the `assembly_error_code` response's property default value `UNKNOWN_ASSEMBLY_ERROR_CODE` 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_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 `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 `organelle_error_code` response's property default value `UNKNOWN_ORGANELLE_ERROR_CODE` was removed for the status `200`
  - the `rank` response's property default value `NO_RANK` 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 `taxonomy_error_code` response's property default value `UNKNOWN_TAXONOMY_ERROR_CODE` was removed for the status `200`
  - the `type` response's property default value `COUNT_TYPE_UNSPECIFIED` 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`
  - 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, 12 warning, 11 info
  - removed the media type `application/json` for the response with the status `default`
  - removed the optional property `taxonomy_nodes/items/taxonomy/_indexed_names` from the response with the `200` status
  - added the new `COUNT_TYPE_ORGANELLE` enum value to the `taxonomy_nodes/items/taxonomy/counts/items/type` response property for the response status `200`
  - added the new `INVALID_BIOSAMPLE_IDS` enum value to the `messages/items/error/assembly_error_code` response property for the response status `200`
  - added the new `INVALID_BIOSAMPLE_IDS` enum value to the `taxonomy_nodes/items/errors/items/assembly_error_code` response property for the response status `200`
  - added the new `INVALID_WGS_ACCESSIONS` enum value to the `messages/items/error/assembly_error_code` response property for the response status `200`
  - added the new `INVALID_WGS_ACCESSIONS` enum value to the `taxonomy_nodes/items/errors/items/assembly_error_code` response property for the response status `200`
  - added the new `NO_ASSEMBLIES_FOR_ASSEMBLY_NAMES` enum value to the `messages/items/error/assembly_error_code` response property for the response status `200`
  - added the new `NO_ASSEMBLIES_FOR_ASSEMBLY_NAMES` enum value to the `taxonomy_nodes/items/errors/items/assembly_error_code` response property for the response status `200`
  - added the new `NO_ASSEMBLIES_FOR_BIOSAMPLE_IDS` enum value to the `messages/items/error/assembly_error_code` response property for the response status `200`
  - added the new `NO_ASSEMBLIES_FOR_BIOSAMPLE_IDS` enum value to the `taxonomy_nodes/items/errors/items/assembly_error_code` response property for the response status `200`
  - added the new `NO_ASSEMBLIES_FOR_WGS_ACCESSIONS` enum value to the `messages/items/error/assembly_error_code` response property for the response status `200`
  - added the new `NO_ASSEMBLIES_FOR_WGS_ACCESSIONS` enum value to the `taxonomy_nodes/items/errors/items/assembly_error_code` response property for the response status `200`
  - added the new optional request property `children`
  - added the new optional request property `include_tabular_header`
  - added the new optional request property `page_size`
  - added the new optional request property `page_token`
  - added the new optional request property `ranks`
  - added the new optional request property `table_format`
  - added the media type `text/plain` for the response with the status `default`
  - added the optional property `messages/items/error/organelle_error_code` to the response with the `200` status
  - added the optional property `messages/items/error/taxonomy_error_code` to the response with the `200` status
  - added the optional property `taxonomy_nodes/items/errors/items/organelle_error_code` to the response with the `200` status
  - added the optional property `taxonomy_nodes/items/errors/items/taxonomy_error_code` to the response with the `200` status
- **2023-11-14** `b4da81b65e0a`: 10 warning, 7 info
  - removed the optional property `messages/items/error/valid_identifiers` from the response with the `200` status
  - removed the optional property `taxonomy_nodes/items/errors/items/valid_identifiers` from the response with the `200` status
  - added the new `ABOVE_SPECIES_TAXON` enum value to the `messages/items/warning/gene_warning_code` response property for the response status `200`
  - added the new `ABOVE_SPECIES_TAXON` enum value to the `taxonomy_nodes/items/warnings/items/gene_warning_code` response property for the response status `200`
  - added the new `INVALID_TAXON_GENE_ARGUMENT` enum value to the `messages/items/error/gene_error_code` response property for the response status `200`
  - added the new `INVALID_TAXON_GENE_ARGUMENT` enum value to the `taxonomy_nodes/items/errors/items/gene_error_code` response property for the response status `200`
  - added the new `MISSING_SEARCH_FIELD` enum value to the `messages/items/error/assembly_error_code` response property for the response status `200`
  - added the new `MISSING_SEARCH_FIELD` enum value to the `taxonomy_nodes/items/errors/items/assembly_error_code` response property for the response status `200`
  - added the new `NO_GENE_ANNOTATION_FOUND` enum value to the `messages/items/warning/gene_warning_code` response property for the response status `200`
  - added the new `NO_GENE_ANNOTATION_FOUND` enum value to the `taxonomy_nodes/items/warnings/items/gene_warning_code` response property for the response status `200`
  - added the new `METADATA` enum value to the request property `returned_content`
  - added the optional property `taxonomy_nodes/items/taxonomy/acronyms` to the response with the `200` status
  - added the optional property `taxonomy_nodes/items/taxonomy/blast_name` to the response with the `200` status
  - added the optional property `taxonomy_nodes/items/taxonomy/extinct` to the response with the `200` status
  - added the optional property `taxonomy_nodes/items/taxonomy/genbank_acronym` to the response with the `200` status
  - added the optional property `taxonomy_nodes/items/taxonomy/genbank_common_name` to the response with the `200` status
  - added the optional property `taxonomy_nodes/items/taxonomy/genomic_moltype` to the response with the `200` status

---

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