---
title: "Get a gene data package by GeneID"
method: GET
path: "/gene/id/{gene_ids}/download"
tags: ["Gene"]
---

# Get a gene data package by GeneID

`GET /gene/id/{gene_ids}/download`

## Request

- Base URL: `https://api.ncbi.nlm.nih.gov/datasets/v2`
- URL: `https://api.ncbi.nlm.nih.gov/datasets/v2/gene/id/{gene_ids}/download`
- Auth: API key in header `api-key`

Download a gene data package including sequence, annotation and data reports, as a compressed zip archive, by GeneID.

## Path parameters

- `gene_ids` integer[], required

## Query parameters

- `include_annotation_type` V2Fasta[]
- `accession_filter` string[]
- `aux_report` V2GeneDatasetRequestGeneDatasetReportType[]
- `tabular_reports` V2GeneDatasetRequestGeneDatasetReportType[]
- `filename` string

## Response `200`

A successful response

## Other responses

- `default`: An unexpected error response.

## Changes

- **2026-08-06** `e5d4400c8e5d`: 3 warning
  - deleted the `query` request parameter `fasta_filter`
  - deleted the `query` request parameter `table_fields`
  - deleted the `query` request parameter `table_report_type`
- **2025-05-08** `6b24249801ec`: 1 breaking
  - for the `query` request parameter `table_report_type`, default value `DATASET_REPORT` was added
- **2025-04-28** `f08be9b66e16`: 1 breaking, 2 info
  - for the `query` request parameter `table_report_type`, default value `DATASET_REPORT` was removed
  - added the new optional `query` request parameter `accession_filter`
  - added the new optional `query` request parameter `tabular_reports`
- **2025-02-08** `00bdccfc6283`: 1 breaking, 1 info
  - removed the media type `application/json` for the response with the status `default`
  - added the media type `text/plain` for the response with the status `default`
- **2023-11-14** `b4da81b65e0a`: 1 info
  - added the new optional `query` request parameter `table_report_type`

[Operation history](https://skmtc.dev/ncats/apis/ncbi-datasets-api/changes/gene/id/:gene_ids/download/get.md)

---

[API](https://skmtc.dev/ncats/apis/ncbi-datasets-api.md) - [All operations](https://skmtc.dev/ncats/apis/ncbi-datasets-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ncats/apis/ncbi-datasets-api/revisions/b24db4bc7ca5?raw)