---
title: "Get a virus data report"
method: POST
path: "/virus"
tags: ["Virus"]
---

# Get a virus data report

`POST /virus`

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

## Request body

- V2VirusDataReportRequest
  - `filter` V2VirusDatasetFilter
    - `accessions` string[]
    - `taxon` string
    - `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
  - `returned_content` 'COMPLETE' | 'ACCESSIONS_ONLY'
  - `table_fields` string[]
  - `table_format` 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/revisions/e5d4400c8e5d/schema)