GET /virus/taxon/{taxon}/genome/table
Summary: Get virus genome metadata in a tabular format
Operation ID: virus_genome_table
Auth: unknown
Operation ID: virus_genome_table
Auth: unknown
Description
Get virus genome metadata in tabular format for virus genomes by taxon.
Parameters (15)
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.
format
(?, query, optional, default: tsv)
Choose download format (tsv, csv or jsonl)
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)
table_fields
(array, query, optional)
Specify which fields to include in the tabular report
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 virus genome metadata in a tabular format | openapi-spec |
https://api.ncbi.nlm.nih.gov/datasets/v2/virus/taxon/1335626/genome/table?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&table_fields=['protein_accession', 'protein_name']&include_sequence=['GENOME', 'CDS', 'PROTEIN']&aux_report=BIOSAMPLE&format=tsv |
Probe History
Status Codes
| Time | Status | Latency | Size |
|---|---|---|---|
| 2026-03-23 09:43:11.407602 | 400 | 337ms |