---
title: "Get SARS-CoV-2 protein metadata in a tabular format by protein name"
method: GET
path: "/virus/taxon/sars2/protein/{proteins}/table"
tags: ["Virus"]
---

# Get SARS-CoV-2 protein metadata in a tabular format by protein name

`GET /virus/taxon/sars2/protein/{proteins}/table`

## Request

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

Get SARS-CoV-2 protein metadata in a tabular format by protein name.

## Path parameters

- `proteins` string[], required

## Query parameters

- `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[]
- `format` 'tsv' | 'csv' | 'jsonl'
- `filename` string

## Response `200`

A successful response

- GoogleapiHttpBody
  - `content_type` string
  - `data` string, byte
  - `extensions` ProtobufAny[]
    - `type_url` string
    - `value` string, byte

## Other responses

- `default`: An unexpected error response.

## Changes

- **2026-09-28** `3f573d3bf03f`: 3 info
  - added the new optional `query` request parameter `filename`
  - added the optional property `content_type` to the response with the `200` status
  - added the optional property `extensions` to the response with the `200` status
- **2026-08-06** `e5d4400c8e5d`: 2 warning
  - deleted the `query` request parameter `aux_report`
  - deleted the `query` request parameter `include_sequence`
- **2025-05-08** `6b24249801ec`: 1 breaking
  - for the `query` request parameter `format`, default value `tsv` was added
- **2025-04-28** `f08be9b66e16`: 1 breaking
  - for the `query` request parameter `format`, 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 `query` request parameter `pangolin_classification`
  - added the new optional `query` request parameter `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/:proteins/table/get.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)