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

# Get a download summary (preview) of a genome annotation data package by genome assembly accession

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

## 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_summary`
- Auth: API key in header `api-key`

Get a downlaod summary (preview) of a genome annotation data package, including counts and file sizes, in JSON format.

## 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[]

## Response `200`

A successful response

- V2DownloadSummary
  - `record_count` integer
  - `assembly_count` integer
  - `resource_updated_on` string, date-time
  - `hydrated` V2DownloadSummaryHydrated
    - `estimated_file_size_mb` integer
    - `url` string
    - `cli_download_command_line` string
  - `dehydrated` V2DownloadSummaryDehydrated
    - `estimated_file_size_mb` integer
    - `url` string
    - `cli_download_command_line` string
    - `cli_rehydrate_command_line` string
  - `errors` V2reportsError[]
    - `assembly_error_code` 'UNKNOWN_ASSEMBLY_ERROR_CODE' | 'INVALID_BIOPROJECT_IDS' | 'NO_ASSEMBLIES_FOR_BIOPROJECTS' | 'INVALID_TAXON' | 'MISSING_SEARCH_FIELD' | 'INVALID_BIOSAMPLE_IDS' | 'NO_ASSEMBLIES_FOR_BIOSAMPLE_IDS' | 'NO_ASSEMBLIES_FOR_ASSEMBLY_NAMES' | 'INVALID_WGS_ACCESSIONS' | 'NO_ASSEMBLIES_FOR_WGS_ACCESSIONS'
    - `gene_error_code` 'UNKNOWN_GENE_ERROR_CODE' | 'INCOMPLETE_LOOKUP_SYMBOL' | 'INVALID_TAXON_GENE_ARGUMENT'
    - `organelle_error_code` 'UNKNOWN_ORGANELLE_ERROR_CODE' | 'INVALID_ORGANELLE_TAXON' | 'NO_ORGANELLES_FOR_ACCESSION'
    - `virus_error_code` 'UNKNOWN_VIRUS_ERROR_CODE'
    - `taxonomy_error_code` 'UNKNOWN_TAXONOMY_ERROR_CODE' | 'INVALID_TAXONOMY_TAXON'
    - `sequence_error_code` 'UNKNOWN_SEQUENCE_ERROR_CODE' | 'INVALID_SEQUENCE_ACCESSION'
    - `reason` string
    - `message` string
    - `invalid_identifiers` string[]
  - `messages` V2reportsMessage[]
    - `error` V2reportsError
      - `assembly_error_code` 'UNKNOWN_ASSEMBLY_ERROR_CODE' | 'INVALID_BIOPROJECT_IDS' | 'NO_ASSEMBLIES_FOR_BIOPROJECTS' | 'INVALID_TAXON' | 'MISSING_SEARCH_FIELD' | 'INVALID_BIOSAMPLE_IDS' | 'NO_ASSEMBLIES_FOR_BIOSAMPLE_IDS' | 'NO_ASSEMBLIES_FOR_ASSEMBLY_NAMES' | 'INVALID_WGS_ACCESSIONS' | 'NO_ASSEMBLIES_FOR_WGS_ACCESSIONS'
      - `gene_error_code` 'UNKNOWN_GENE_ERROR_CODE' | 'INCOMPLETE_LOOKUP_SYMBOL' | 'INVALID_TAXON_GENE_ARGUMENT'
      - `organelle_error_code` 'UNKNOWN_ORGANELLE_ERROR_CODE' | 'INVALID_ORGANELLE_TAXON' | 'NO_ORGANELLES_FOR_ACCESSION'
      - `virus_error_code` 'UNKNOWN_VIRUS_ERROR_CODE'
      - `taxonomy_error_code` 'UNKNOWN_TAXONOMY_ERROR_CODE' | 'INVALID_TAXONOMY_TAXON'
      - `sequence_error_code` 'UNKNOWN_SEQUENCE_ERROR_CODE' | 'INVALID_SEQUENCE_ACCESSION'
      - `reason` string
      - `message` string
      - `invalid_identifiers` string[]
    - `warning` V2reportsWarning
      - `gene_warning_code` 'UNKNOWN_GENE_WARNING_CODE' | 'ACCESSION_VERSION_MISMATCH' | 'REPLACED_GENE_ID' | 'DISCONTINUED_GENE_ID' | 'UNRECOGNIZED_GENE_ID' | 'UNRECOGNIZED_GENE_SYMBOL' | 'UNRECOGNIZED_ACCESSION' | 'UNRECOGNIZED_TAX_TOKEN' | 'NO_GENE_ANNOTATION_FOUND' | 'ABOVE_SPECIES_TAXON'
      - `reason` string
      - `message` string
      - `replaced_id` V2reportsWarningReplacedId
        - `requested` string
        - `returned` string
      - `unrecognized_identifier` string
  - `available_files` V2DownloadSummaryAvailableFiles
    - `all_genomic_fasta` V2DownloadSummaryFileSummary
      - `file_count` integer
      - `size_mb` number, float
    - `genome_gff` V2DownloadSummaryFileSummary
      - `file_count` integer
      - `size_mb` number, float
    - `genome_gbff` V2DownloadSummaryFileSummary
      - `file_count` integer
      - `size_mb` number, float
    - `rna_fasta` V2DownloadSummaryFileSummary
      - `file_count` integer
      - `size_mb` number, float
    - `prot_fasta` V2DownloadSummaryFileSummary
      - `file_count` integer
      - `size_mb` number, float
    - `genome_gtf` V2DownloadSummaryFileSummary
      - `file_count` integer
      - `size_mb` number, float
    - `cds_fasta` V2DownloadSummaryFileSummary
      - `file_count` integer
      - `size_mb` number, float
    - `sequence_report` V2DownloadSummaryFileSummary
      - `file_count` integer
      - `size_mb` number, float
    - `annotation_report` V2DownloadSummaryFileSummary
      - `file_count` integer
      - `size_mb` number, float

## Other responses

- `default`: An unexpected error response.

## Changes

- **2026-08-06** `e5d4400c8e5d`: 3 warning, 3 info
  - deleted the `query` request parameter `include_tabular_header`
  - deleted the `query` request parameter `table_fields`
  - deleted the `query` request parameter `table_format`
  - added the enum value `DEFAULT` to the property `items/` of the `query` request parameter `include_annotation_type`
  - …2 more
- **2025-05-08** `6b24249801ec`: 3 breaking, 11 info
  - 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
  - the `assembly_error_code` response's property default value `UNKNOWN_ASSEMBLY_ERROR_CODE` was added for the status `200`
  - …10 more
- **2025-04-28** `f08be9b66e16`: 3 breaking, 11 info
  - 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
  - the `assembly_error_code` response's property default value `UNKNOWN_ASSEMBLY_ERROR_CODE` was removed for the status `200`
  - …10 more
- …earlier changes not shown

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