---
title: "Changes to Get gene metadata as JSON"
method: POST
path: "/gene"
---

# Changes to Get gene metadata as JSON

`POST /gene`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 13 revisions.

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

## Changes

- **2026-08-06** `e5d4400c8e5d`: 11 info
  - endpoint deprecated
  - added the optional property `messages/items/error/sequence_error_code` to the response with the `200` status (media type: application/json)
  - added the optional property `messages/items/error/sequence_error_code` to the response with the `200` status (media type: application/x-ndjson)
  - added the optional property `reports/items/errors/items/sequence_error_code` to the response with the `200` status (media type: application/json)
  - added the optional property `reports/items/errors/items/sequence_error_code` to the response with the `200` status (media type: application/x-ndjson)
  - added the optional property `reports/items/expression` to the response with the `200` status (media type: application/json)
  - added the optional property `reports/items/expression` to the response with the `200` status (media type: application/x-ndjson)
  - added the optional property `reports/items/gene/alternate_names` to the response with the `200` status (media type: application/json)
  - added the optional property `reports/items/gene/alternate_names` to the response with the `200` status (media type: application/x-ndjson)
  - added the optional property `reports/items/gene/map_locations` to the response with the `200` status (media type: application/json)
  - added the optional property `reports/items/gene/map_locations` to the response with the `200` status (media type: application/x-ndjson)
- **2025-06-12** `7c5b2501b6fc`: 2 info
  - added the new optional request property `sort`
  - added the new optional request property `tax_search_subtree`
- **2025-05-08** `6b24249801ec`: 1 breaking, 66 info
  - removed the enum value `PRODUCT` of the request property `returned_content`
  - endpoint reactivated
  - the `` request property default value `UNKNOWN` 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 `assembly_error_code` response's property default value `UNKNOWN_ASSEMBLY_ERROR_CODE` was added for the status `200` (media type: application/json)
  - the `assembly_error_code` response's property default value `UNKNOWN_ASSEMBLY_ERROR_CODE` was added for the status `200` (media type: application/json)
  - the `assembly_error_code` response's property default value `UNKNOWN_ASSEMBLY_ERROR_CODE` was added for the status `200` (media type: application/x-ndjson)
  - the `assembly_error_code` response's property default value `UNKNOWN_ASSEMBLY_ERROR_CODE` was added for the status `200` (media type: application/x-ndjson)
  - the `gene_error_code` response's property default value `UNKNOWN_GENE_ERROR_CODE` was added for the status `200` (media type: application/json)
  - the `gene_error_code` response's property default value `UNKNOWN_GENE_ERROR_CODE` was added for the status `200` (media type: application/json)
  - the `gene_error_code` response's property default value `UNKNOWN_GENE_ERROR_CODE` was added for the status `200` (media type: application/x-ndjson)
  - the `gene_error_code` response's property default value `UNKNOWN_GENE_ERROR_CODE` was added for the status `200` (media type: application/x-ndjson)
  - the `gene_warning_code` response's property default value `UNKNOWN_GENE_WARNING_CODE` was added for the status `200` (media type: application/json)
  - the `gene_warning_code` response's property default value `UNKNOWN_GENE_WARNING_CODE` was added for the status `200` (media type: application/json)
  - the `gene_warning_code` response's property default value `UNKNOWN_GENE_WARNING_CODE` was added for the status `200` (media type: application/json)
  - the `gene_warning_code` response's property default value `UNKNOWN_GENE_WARNING_CODE` was added for the status `200` (media type: application/x-ndjson)
  - the `gene_warning_code` response's property default value `UNKNOWN_GENE_WARNING_CODE` was added for the status `200` (media type: application/x-ndjson)
  - the `gene_warning_code` response's property default value `UNKNOWN_GENE_WARNING_CODE` was added for the status `200` (media type: application/x-ndjson)
  - the `organelle_error_code` response's property default value `UNKNOWN_ORGANELLE_ERROR_CODE` was added for the status `200` (media type: application/json)
  - the `organelle_error_code` response's property default value `UNKNOWN_ORGANELLE_ERROR_CODE` was added for the status `200` (media type: application/json)
  - the `organelle_error_code` response's property default value `UNKNOWN_ORGANELLE_ERROR_CODE` was added for the status `200` (media type: application/x-ndjson)
  - the `organelle_error_code` response's property default value `UNKNOWN_ORGANELLE_ERROR_CODE` 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/json)
  - 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/json)
  - 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/json)
  - 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/json)
  - the `orientation` response's property default value `none` 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/x-ndjson)
  - the `orientation` response's property default value `none` 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/x-ndjson)
  - the `orientation` response's property default value `none` 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/x-ndjson)
  - the `orientation` response's property default value `none` 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/x-ndjson)
  - the `rna_type` response's property default value `rna_UNKNOWN` was added for the status `200` (media type: application/json)
  - …27 more
- **2025-04-28** `f08be9b66e16`: 68 info
  - endpoint deprecated
  - added the new optional request property `accession_filter`
  - added the new optional request property `locus_tags`
  - the `` request property default value `UNKNOWN` 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 `assembly_error_code` response's property default value `UNKNOWN_ASSEMBLY_ERROR_CODE` was removed for the status `200` (media type: application/json)
  - the `assembly_error_code` response's property default value `UNKNOWN_ASSEMBLY_ERROR_CODE` was removed for the status `200` (media type: application/json)
  - the `assembly_error_code` response's property default value `UNKNOWN_ASSEMBLY_ERROR_CODE` was removed for the status `200` (media type: application/x-ndjson)
  - the `assembly_error_code` response's property default value `UNKNOWN_ASSEMBLY_ERROR_CODE` was removed for the status `200` (media type: application/x-ndjson)
  - the `gene_error_code` response's property default value `UNKNOWN_GENE_ERROR_CODE` was removed for the status `200` (media type: application/json)
  - the `gene_error_code` response's property default value `UNKNOWN_GENE_ERROR_CODE` was removed for the status `200` (media type: application/json)
  - the `gene_error_code` response's property default value `UNKNOWN_GENE_ERROR_CODE` was removed for the status `200` (media type: application/x-ndjson)
  - the `gene_error_code` response's property default value `UNKNOWN_GENE_ERROR_CODE` was removed for the status `200` (media type: application/x-ndjson)
  - the `gene_warning_code` response's property default value `UNKNOWN_GENE_WARNING_CODE` was removed for the status `200` (media type: application/json)
  - the `gene_warning_code` response's property default value `UNKNOWN_GENE_WARNING_CODE` was removed for the status `200` (media type: application/json)
  - the `gene_warning_code` response's property default value `UNKNOWN_GENE_WARNING_CODE` was removed for the status `200` (media type: application/json)
  - the `gene_warning_code` response's property default value `UNKNOWN_GENE_WARNING_CODE` was removed for the status `200` (media type: application/x-ndjson)
  - the `gene_warning_code` response's property default value `UNKNOWN_GENE_WARNING_CODE` was removed for the status `200` (media type: application/x-ndjson)
  - the `gene_warning_code` response's property default value `UNKNOWN_GENE_WARNING_CODE` was removed for the status `200` (media type: application/x-ndjson)
  - the `organelle_error_code` response's property default value `UNKNOWN_ORGANELLE_ERROR_CODE` was removed for the status `200` (media type: application/json)
  - the `organelle_error_code` response's property default value `UNKNOWN_ORGANELLE_ERROR_CODE` was removed for the status `200` (media type: application/json)
  - the `organelle_error_code` response's property default value `UNKNOWN_ORGANELLE_ERROR_CODE` was removed for the status `200` (media type: application/x-ndjson)
  - the `organelle_error_code` response's property default value `UNKNOWN_ORGANELLE_ERROR_CODE` 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/json)
  - 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/json)
  - 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/json)
  - 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/json)
  - the `orientation` response's property default value `none` 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/x-ndjson)
  - the `orientation` response's property default value `none` 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/x-ndjson)
  - the `orientation` response's property default value `none` 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/x-ndjson)
  - the `orientation` response's property default value `none` 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/x-ndjson)
  - …28 more
- **2025-02-08** `00bdccfc6283`: 1 breaking, 14 warning, 11 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 `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 `reports/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 `reports/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 `reports/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 `reports/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 `reports/items/errors/items/assembly_error_code` response property for the response status `200`
  - added the new optional request property `include_tabular_header`
  - 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 `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 `reports/items/errors/items/organelle_error_code` to the response with the `200` status
  - added the optional property `reports/items/errors/items/taxonomy_error_code` to the response with the `200` status
  - added the optional property `reports/items/gene/gene_ontology` to the response with the `200` status
  - added the optional property `reports/items/gene/locus_tag` to the response with the `200` status
  - added the optional property `reports/items/gene/summary` to the response with the `200` status
  - added the optional property `reports/items/product/transcripts/items/select_category` to the response with the `200` status
- **2023-11-14** `b4da81b65e0a`: 10 warning, 3 info
  - removed the optional property `messages/items/error/valid_identifiers` from the response with the `200` status
  - removed the optional property `reports/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 `reports/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 `reports/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 `reports/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 `reports/items/warnings/items/gene_warning_code` response property for the response status `200`
  - added the new optional request property `table_format`
  - added the optional property `_report_format` to the response with the `200` status
  - added the optional property `reports/items/warning` to the response with the `200` status

---

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