--- title: "Changes to Use taxonomic identifiers to get taxonomic metadata" method: GET path: "/taxonomy/taxon/{taxons}" --- # Changes to Use taxonomic identifiers to get taxonomic metadata `GET /taxonomy/taxon/{taxons}` > 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`: 3 breaking, 14 info - **2025-04-28** `f08be9b66e16`: 3 breaking, 4 warning, 18 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`: 3 breaking, 14 info - for the `query` request parameter `include_tabular_header`, default value `INCLUDE_TABULAR_HEADER_FIRST_PAGE_ONLY` was added - for the `query` request parameter `returned_content`, default value `COMPLETE` was added - for the `query` request parameter `table_format`, 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`: 3 breaking, 4 warning, 18 info - for the `query` request parameter `include_tabular_header`, default value `INCLUDE_TABULAR_HEADER_FIRST_PAGE_ONLY` was removed - for the `query` request parameter `returned_content`, default value `COMPLETE` was removed - for the `query` request parameter `table_format`, default value `SUMMARY` was removed - 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` - added the enum value `ACELLULAR_ROOT` to the property `items/` of the `query` request parameter `ranks` - added the enum value `CELLULAR_ROOT` to the property `items/` of the `query` request parameter `ranks` - added the enum value `DOMAIN` to the property `items/` of the `query` request parameter `ranks` - added the enum value `REALM` to the property `items/` of the `query` request parameter `ranks` - 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 `query` request parameter `children` - added the new optional `query` request parameter `include_tabular_header` - added the new optional `query` request parameter `page_size` - added the new optional `query` request parameter `page_token` - added the new optional `query` request parameter `ranks` - added the new optional `query` request parameter `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 enum value `METADATA` to the `query` request parameter `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/taxon/:taxons/get.md) - [API](https://skmtc.dev/ncats/apis/ncbi-datasets-api.md) - [Page](https://skmtc.dev/ncats/apis/ncbi-datasets-api/changes/taxonomy/taxon/:taxons/get)