---
title: "Get a virus data report by taxon"
method: GET
path: "/virus/taxon/{taxon}/dataset_report"
tags: ["Virus"]
---

# Get a virus data report by taxon

`GET /virus/taxon/{taxon}/dataset_report`

Get a virus data report by taxon. By default, in paged JSON format, but also available in tabular (accept: text/tab-separated-values) or JSON Lines (accept: application/x-ndjson) formats.

## Path parameters

- `taxon` string, required

## Query parameters

- `filter.refseq_only` boolean
- `filter.annotated_only` boolean
- `filter.released_since` string, date-time
- `filter.updated_since` string, date-time
- `filter.host` string
- `filter.pangolin_classification` string
- `filter.geo_location` string
- `filter.usa_state` string
- `filter.complete_only` boolean
- `returned_content` 'COMPLETE' | 'ACCESSIONS_ONLY'
- `table_fields` string[]
- `page_size` integer
- `page_token` string

## Response `200`

A successful response

- V2reportsVirusDataReportPage
  - `reports` V2reportsVirusAssembly[]
    - `accession` string
    - `is_complete` boolean
    - `is_annotated` boolean
    - `isolate` V2reportsIsolate
      - `name` string
      - `source` string
      - `collection_date` string
    - `source_database` string
    - `protein_count` integer
    - `host` V2reportsOrganism
      - `tax_id` integer
      - `sci_name` string
      - `organism_name` string
      - `common_name` string
      - `lineage` V2reportsLineageOrganism[]
        - `tax_id` integer
        - `name` string
      - `strain` string
      - `pangolin_classification` string
      - `infraspecific_names` V2reportsInfraspecificNames
        - `breed` string
        - `cultivar` string
        - `ecotype` string
        - `isolate` string
        - `sex` string
        - `strain` string
    - `virus` V2reportsOrganism
      - `tax_id` integer
      - `sci_name` string
      - `organism_name` string
      - `common_name` string
      - `lineage` V2reportsLineageOrganism[]
        - `tax_id` integer
        - `name` string
      - `strain` string
      - `pangolin_classification` string
      - `infraspecific_names` V2reportsInfraspecificNames
        - `breed` string
        - `cultivar` string
        - `ecotype` string
        - `isolate` string
        - `sex` string
        - `strain` string
    - `bioprojects` string[]
    - `location` V2reportsVirusAssemblyCollectionLocation
      - `geographic_location` string
      - `geographic_region` string
      - `usa_state` string
    - `update_date` string
    - `release_date` string
    - `nucleotide_completeness` string
    - `completeness` 'UNKNOWN' | 'COMPLETE' | 'PARTIAL'
    - `length` integer
    - `gene_count` integer
    - `mature_peptide_count` integer
    - `biosample` string
    - `mol_type` string
    - `nucleotide` V2reportsSeqRangeSetFasta
      - `seq_id` string
      - `accession_version` string
      - `title` string
      - `sequence_hash` string
      - `range` V2reportsRange[]
        - `begin` string, uint64
        - `end` string, uint64
        - `orientation` 'none' | 'plus' | 'minus'
        - `order` integer
        - `ribosomal_slippage` integer
    - `purpose_of_sampling` 'PURPOSE_OF_SAMPLING_UNKNOWN' | 'PURPOSE_OF_SAMPLING_BASELINE_SURVEILLANCE'
    - `sra_accessions` string[]
    - `submitter` V2reportsVirusAssemblySubmitterInfo
      - `names` string[]
      - `affiliation` string
      - `country` string
    - `lab_host` string
    - `is_lab_host` boolean
    - `is_vaccine_strain` boolean
    - `segment` string
  - `total_count` integer
  - `next_page_token` string

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/ncats/apis/ncbi-datasets-api.md) · [All operations](https://skmtc.net/ncats/apis/ncbi-datasets-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ncats/ncbi-datasets-api/versions/e5d4400c8e5d/schema)