---
title: "Changes to Get gene metadata by RefSeq Accession"
method: GET
path: "/gene/accession/{accessions}"
---

# Changes to Get gene metadata by RefSeq Accession

`GET /gene/accession/{accessions}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 7 of 13 revisions.

- **2026-08-06** `e5d4400c8e5d`: 11 info
- **2025-09-29** `e17d9b32b6e0`: 1 info
- **2025-06-12** `7c5b2501b6fc`: 2 info
- **2025-05-08** `6b24249801ec`: 3 breaking, 63 info
- **2025-04-28** `f08be9b66e16`: 2 breaking, 65 info
- **2025-02-08** `00bdccfc6283`: 1 breaking, 14 warning, 11 info
- **2023-11-14** `b4da81b65e0a`: 10 warning, 2 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-09-29** `e17d9b32b6e0`: 1 info
  - added the new optional `query` request parameter `tax_search_subtree`
- **2025-06-12** `7c5b2501b6fc`: 2 info
  - added the new optional `query` request parameter `sort.direction`
  - added the new optional `query` request parameter `sort.field`
- **2025-05-08** `6b24249801ec`: 3 breaking, 63 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
  - removed the enum value `PRODUCT` from the `query` request parameter `returned_content`
  - endpoint reactivated
  - 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)
  - the `rna_type` response's property default value `rna_UNKNOWN` was added for the status `200` (media type: application/json)
  - …26 more
- **2025-04-28** `f08be9b66e16`: 2 breaking, 65 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
  - endpoint deprecated
  - added the new optional `query` request parameter `accession_filter`
  - added the new optional `query` request parameter `locus_tags`
  - 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)
  - the `rna_type` response's property default value `rna_UNKNOWN` was removed for the status `200` (media type: application/json)
  - …27 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 `query` request parameter `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, 2 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 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/accession/:accessions/get.md) - [API](https://skmtc.dev/ncats/apis/ncbi-datasets-api.md) - [Page](https://skmtc.dev/ncats/apis/ncbi-datasets-api/changes/gene/accession/:accessions/get)