GET /gene/id/{gene_ids}
Summary: Get gene reports by GeneID
Operation ID: gene_reports_by_id
Auth: unknown
Operation ID: gene_reports_by_id
Auth: unknown
Description
Get a gene summary by GeneID. By default, in paged JSON format, but also available as tabular (accept: text/tab-separated-values) or json-lines (accept: application/x-ndjson)
Parameters (11)
accession_filter
(array, query, optional)
Filter tabular product report to only include the selected accessions. Use of this parameter requires the HTTP header, `accept: text/tab-separated-values`.
gene_ids
(array, path, required)
One or more NCBI GeneIDs
include_tabular_header
(?, query, optional)
Specify when to include the table header when requesting a tabular report.
locus_tags
(array, query, optional)
Gene locus tags
page_size
(integer, query, optional, default: 20)
The maximum number of gene reports to return. Default is 20 and maximum is 1000. If the number of results exceeds the page size, `page_token` can be used to retrieve the remaining results.
page_token
(string, query, optional)
A page token is returned when the results count exceeds `page size`. Use this token along with previous request parameters to retrieve the next page of results. When `page_token` is empty, all results have been retrieved.
returned_content
(?, query, optional)
Return complete gene reports, or abbreviated reports with either GeneIDs only or GeneIDs, transcript and protein counts.
sort.direction
(?, query, optional)
sort.field
(string, query, optional)
table_fields
(array, query, optional)
Specify which fields to include in the tabular report. Additional fields are described here: [Create a table from the gene data reports](https://www.ncbi.nlm.nih.gov/datasets/docs/v2/command-line-tools/using-dataformat/gene-data-reports/). Use of this parameter requires the HTTP header, `accept: text/tab-separated-values`.
tax_search_subtree
(boolean, query, optional, default: False)
If true, include genes from taxonomic ranks below the requested taxon.
Examples (1)
| Title | Type | URL | Action |
|---|---|---|---|
| Get gene reports by GeneID (deprecated) | openapi-spec |
https://api.ncbi.nlm.nih.gov/datasets/v2/gene/id/59067?returned_content=IDS_ONLY&locus_tags=b0001&table_fields=['gene-id', 'gene-type', 'description']&accession_filter=['NM_001407959.1', 'NM_001408458.1'] |
Probe History
Status Codes
| Time | Status | Latency | Size |
|---|---|---|---|
| 2026-03-23 10:20:29.094546 | 200 | 433ms |