---
title: "Get a genome annotation data package by genome assembly accession"
method: GET
path: "/genome/accession/{accession}/annotation_report/download"
tags: ["Genome"]
---

# Get a genome annotation data package by genome assembly accession

`GET /genome/accession/{accession}/annotation_report/download`

## Request

- Base URL: `https://api.ncbi.nlm.nih.gov/datasets/v2`
- URL: `https://api.ncbi.nlm.nih.gov/datasets/v2/genome/accession/{accession}/annotation_report/download`
- Auth: API key in header `api-key`

Download an annotation data package including sequence and a detailed annotation report by genome assembly accession.

## Path parameters

- `accession` string, required

## Query parameters

- `annotation_ids` string[]
- `symbols` string[]
- `locations` string[]
- `gene_types` string[]
- `search_text` string[]
- `sort.field` string
- `sort.direction` 'SORT_DIRECTION_UNSPECIFIED' | 'SORT_DIRECTION_ASCENDING' | 'SORT_DIRECTION_DESCENDING'
- `include_annotation_type` V2GenomeAnnotationRequestAnnotationType[]
- `filename` string

## Response `200`

A successful response

## Other responses

- `default`: An unexpected error response.

## Changes

- **2026-08-06** `e5d4400c8e5d`: 5 warning, 1 info
  - deleted the `query` request parameter `include_tabular_header`
  - deleted the `query` request parameter `page_size`
  - deleted the `query` request parameter `page_token`
  - deleted the `query` request parameter `table_fields`
  - …2 more
- **2025-05-08** `6b24249801ec`: 3 breaking
  - for the `query` request parameter `include_tabular_header`, default value `INCLUDE_TABULAR_HEADER_FIRST_PAGE_ONLY` was added
  - for the `query` request parameter `sort.direction`, default value `SORT_DIRECTION_UNSPECIFIED` was added
  - for the `query` request parameter `table_format`, default value `NO_TABLE` was added
- **2025-04-28** `f08be9b66e16`: 3 breaking
  - for the `query` request parameter `include_tabular_header`, default value `INCLUDE_TABULAR_HEADER_FIRST_PAGE_ONLY` was removed
  - for the `query` request parameter `sort.direction`, default value `SORT_DIRECTION_UNSPECIFIED` was removed
  - for the `query` request parameter `table_format`, default value `NO_TABLE` was removed
- **2025-02-08** `00bdccfc6283`: 2 breaking, 1 info
  - removed the enum value `DEFAULT` from the property `items/` of the `query` request parameter `include_annotation_type`
  - 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
  - endpoint added

[Operation history](https://skmtc.dev/ncats/apis/ncbi-datasets-api/changes/genome/accession/:accession/annotation_report/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)