---
title: "Get a virus annotation report by nucleotide accession"
method: GET
path: "/virus/accession/{accessions}/annotation_report"
tags: ["Virus"]
---

# Get a virus annotation report by nucleotide accession

`GET /virus/accession/{accessions}/annotation_report`

Get a virus annotation report by nucleotide accesion. 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

- `accessions` 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
- `table_fields` string[]
- `page_size` integer
- `page_token` string

## Response `200`

A successful response

- V2reportsVirusAnnotationReportPage
  - `reports` V2reportsVirusAnnotationReport[]
    - `accession` string
    - `isolate_name` string
    - `genes` V2reportsVirusGene[]
      - `name` string
      - `gene_id` integer
      - `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
      - `cds` V2reportsVirusPeptide[]
        - `accession` string
        - `name` string
        - `other_names` 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
        - `protein` 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
        - `pdb_ids` string[]
        - `cdd` V2reportsConservedDomain[]
          - `accession` string
          - `name` string
          - `range` V2reportsRange
            - `begin` string, uint64
            - `end` string, uint64
            - `orientation` 'none' | 'plus' | 'minus'
            - `order` integer
            - `ribosomal_slippage` integer
        - `uni_prot_kb` V2reportsVirusPeptideUniProtId
          - `id` string
          - `name` string
        - `mature_peptide` V2reportsVirusPeptide[]
        - `protein_completeness` 'UNKNOWN' | 'COMPLETE' | 'PARTIAL'
  - `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)
