---
title: "Get a SARS-CoV-2 protein data package"
method: POST
path: "/virus/taxon/sars2/protein/download"
tags: ["Virus"]
---

# Get a SARS-CoV-2 protein data package

`POST /virus/taxon/sars2/protein/download`

## Request

- Base URL: `https://api.ncbi.nlm.nih.gov/datasets/v2`
- URL: `https://api.ncbi.nlm.nih.gov/datasets/v2/virus/taxon/sars2/protein/download`
- Auth: API key in header `api-key`

Download a SARS-CoV-2 protein data package including sequence, annotation, BioSample data and a detailed data report.

## Query parameters

- `filename` string

## Request body

- V2Sars2ProteinDatasetRequest
  - `proteins` 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
  - `table_fields` V2VirusTableField[]
  - `include_sequence` V2ViralSequenceType[]
  - `aux_report` V2VirusDatasetReportType[]
  - `format` 'tsv' | 'csv' | 'jsonl'

## Response `200`

A successful response

## Other responses

- `default`: An unexpected error response.

## Changes

- **2026-08-06** `e5d4400c8e5d`: 1 breaking
  - removed the enum value `BIOSAMPLE` of the request property `include_sequence/items/`
- **2025-05-08** `6b24249801ec`: 4 info
  - the `` request property default value `DATASET_REPORT` was added
  - the `` request property default value `GENOME` was added
  - the `` request property default value `unspecified` was added
  - the `format` request property default value `tsv` was added
- **2025-04-28** `f08be9b66e16`: 4 info
  - the `` request property default value `DATASET_REPORT` was removed
  - the `` request property default value `GENOME` was removed
  - the `` request property default value `unspecified` was removed
  - the `format` request property default value `tsv` was removed
- **2025-02-08** `00bdccfc6283`: 1 breaking, 3 info
  - removed the media type `application/json` for the response with the status `default`
  - added the new optional request property `pangolin_classification`
  - added the new optional request property `usa_state`
  - added the media type `text/plain` for the response with the status `default`

[Operation history](https://skmtc.dev/ncats/apis/ncbi-datasets-api/changes/virus/taxon/sars2/protein/download/post.md)

---

[API](https://skmtc.dev/ncats/apis/ncbi-datasets-api.md) - [All operations](https://skmtc.dev/ncats/apis/ncbi-datasets-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ncats/apis/ncbi-datasets-api/revisions/b24db4bc7ca5?raw)