GET /virus/taxon/{taxon}/genome
Summary: Get a download summary of a virus genome data package by taxon
Operation ID: virus_genome_summary
Auth: unknown
Operation ID: virus_genome_summary
Auth: unknown
Description
Get a download summary of a virus genome data package, including counts and file sizes, in JSON format.
Parameters (13)
accessions
(array, query, optional)
One or more nucleotide sequence accessions
annotated_only
(boolean, query, optional, default: False)
If true, limit results to annotated genomes.
aux_report
(array, query, optional)
Specify which report files to include in the data package. The virus data report is always included, and its inclusion is not affected by this parameter.
complete_only
(boolean, query, optional, default: False)
Limit to genomes designated as complete, as defined by the submitter.
geo_location
(string, query, optional)
Limit to genomes collected from the specified geographic location.
host
(string, query, optional)
Limit to genomes isolated from the specified host species (NCBI Taxonomy ID, common or scientific name).
include_sequence
(array, query, optional)
Specify which sequence files to include in the data package.
pangolin_classification
(string, query, optional)
Limit to SARS-CoV-2 genomes from the specified Pango lineage.
refseq_only
(boolean, query, optional, default: False)
If true, limit results to RefSeq genomes.
released_since
(string, query, optional)
taxon
(string, path, required)
NCBI Taxonomy ID or name (common or scientific) at any taxonomic rank
updated_since
(string, query, optional)
usa_state
(string, query, optional)
Limit to genomes collected from the specified U.S. state (two-letter abbreviation).
Examples (1)
| Title | Type | URL | Action |
|---|---|---|---|
| Get a download summary of a virus genome data package by taxon | openapi-spec |
https://api.ncbi.nlm.nih.gov/datasets/v2/virus/taxon/1335626/genome?accessions=NC_038294.1&refseq_only=True&annotated_only=True&released_since=2025-01-15&updated_since=2025-01-15&host=9606&pangolin_classification=LP.8.1&geo_location=USA&usa_state=CA&complete_only=True&include_sequence=['GENOME', 'CDS', 'PROTEIN']&aux_report=BIOSAMPLE |
Probe History
Status Codes
| Time | Status | Latency | Size |
|---|---|---|---|
| 2026-03-23 10:22:33.522960 | 400 | 340ms |