---
title: "Get a virus genome data package by nucleotide accession"
method: GET
path: "/virus/accession/{accessions}/genome/download"
tags: ["Virus"]
---

# Get a virus genome data package by nucleotide accession

`GET /virus/accession/{accessions}/genome/download`

## Request

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

Download a virus genome data package including sequence, annotation, BioSample data and a detailed data report by nucleotide accession.

## Path parameters

- `accessions` string[], required

## Query parameters

- `taxons` string[]
- `refseq_only` boolean
- `annotated_only` boolean
- `released_since` string, date-time
- `updated_since` string, date-time
- `host` string
- `pangolin_classification` string
- `geo_location` string
- `usa_state` string
- `complete_only` boolean
- `include_sequence` V2ViralSequenceType[]
- `aux_report` V2VirusDatasetReportType[]
- `use_psg` boolean
- `filename` string

## Response `200`

A successful response

## Other responses

- `default`: An unexpected error response.

## Changes

- **2026-08-06** `e5d4400c8e5d`: 1 breaking
  - removed the enum value `BIOSAMPLE` from the property `items/` of the `query` request parameter `include_sequence`
- **2025-02-08** `00bdccfc6283`: 1 breaking, 3 info
  - removed the media type `application/json` for the response with the status `default`
  - added the new optional `query` request parameter `taxons`
  - added the new optional `query` request parameter `usa_state`
  - 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 `use_psg`

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