Health — entry 014 of 23
LAPIS
LAPIS is the open, keyless REST API behind covSPECTRUM, serving aggregated counts, sequence details, and mutation queries over SARS-CoV-2 genomic data drawn from public sources like GenBank and Nextstrain, documented via an OpenAPI v2 endpoint at lapis.cov-spectrum.org. The frontend's old ETH Zurich domain, cov-spectrum.ethz.ch, now 301-redirects permanently to cov-spectrum.org — 'url' corrected to the live domain. A live GET against lapis.cov-spectrum.org/open/v2/ returns Access-Control-Allow-Origin: *, reconfirming the stored 'yes' cors.
AuthenticationNone requiredCall it straight away — no key, no signup.
HTTPSSupportedTraffic is encrypted in transit.
CORSEnabledCallable directly from browser JavaScript.
PricingFreeNo paid tier — free for the documented use case.
FormatsJSONResponses can be requested as JSON.
GreatAPIs Score
Score94
Authentication25/25No authentication required
Pricing20/20Free to use
Docs20/20Machine-readable spec file bundled
Formats9/15Single response format
Freshness20/20Verified within 6 months
Embed this badge
<a href="https://greatapis.com/api/lapis/"><img src="https://greatapis.com/badge/lapis.svg" alt="Scored 94 on greatapis.com"></a>Auth quickstart
- No key needed — call it now.
Stored keyNo key stored
Your key is stored only in this browser (localStorage) and sent directly to the API — never to greatapis.
Endpoints
info-controller4
GET/sample/databaseConfig
Parameters
| Name | In | Required | Type |
|---|---|---|---|
X-Request-ID | header | no | — |
downloadAsFile | query | no | boolean |
downloadFileBasename | query | no | string |
compression | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | OK | DatabaseConfig |
500 | Internal Server Error | LapisErrorResponse |
GET/sample/info
Parameters
| Name | In | Required | Type |
|---|---|---|---|
X-Request-ID | header | no | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | OK | LapisInfo |
500 | Internal Server Error | LapisErrorResponse |
GET/sample/lineageDefinition/{column}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
column | path | yes | string |
X-Request-ID | header | no | — |
downloadAsFile | query | no | boolean |
downloadFileBasename | query | no | string |
compression | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | OK | — |
500 | Internal Server Error | LapisErrorResponse |
GET/sample/referenceGenome
Parameters
| Name | In | Required | Type |
|---|---|---|---|
X-Request-ID | header | no | — |
downloadAsFile | query | no | boolean |
downloadFileBasename | query | no | string |
compression | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | OK | ReferenceGenome |
500 | Internal Server Error | LapisErrorResponse |
lapis-controller20
GET/sample/aggregated
Parameters
| Name | In | Required | Type |
|---|---|---|---|
sequenceFilters | query | no | — |
fields | query | no | — |
orderBy | query | no | — |
nucleotideMutations | query | no | — |
aminoAcidMutations | query | no | — |
limit | query | no | — |
offset | query | no | — |
dataFormat | query | no | — |
nucleotideInsertions | query | no | — |
aminoAcidInsertions | query | no | — |
X-Request-ID | header | no | — |
downloadAsFile | query | no | boolean |
downloadFileBasename | query | no | string |
compression | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | OK | AggregatedResponse |
500 | Internal Server Error | LapisErrorResponse |
POST/sample/aggregated
Parameters
| Name | In | Required | Type |
|---|---|---|---|
X-Request-ID | header | no | — |
Request body
application/json — AggregatedPostRequest (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | OK | AggregatedResponse |
500 | Internal Server Error | LapisErrorResponse |
GET/sample/alignedAminoAcidSequences
Parameters
| Name | In | Required | Type |
|---|---|---|---|
genes | query | no | array |
sequenceFilters | query | no | — |
orderBy | query | no | — |
nucleotideMutations | query | no | — |
aminoAcidMutations | query | no | — |
nucleotideInsertions | query | no | — |
aminoAcidInsertions | query | no | — |
limit | query | no | — |
offset | query | no | — |
dataFormat | query | no | — |
fastaHeaderTemplate | query | no | — |
X-Request-ID | header | no | — |
downloadAsFile | query | no | boolean |
downloadFileBasename | query | no | string |
compression | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | OK | — |
500 | Internal Server Error | LapisErrorResponse |
POST/sample/alignedAminoAcidSequences
Parameters
| Name | In | Required | Type |
|---|---|---|---|
X-Request-ID | header | no | — |
Request body
application/json — AllAminoAcidSequenceRequest (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | OK | — |
500 | Internal Server Error | LapisErrorResponse |
GET/sample/alignedAminoAcidSequences/{gene}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
gene | path | yes | — |
sequenceFilters | query | no | — |
orderBy | query | no | — |
nucleotideMutations | query | no | — |
aminoAcidMutations | query | no | — |
nucleotideInsertions | query | no | — |
aminoAcidInsertions | query | no | — |
limit | query | no | — |
offset | query | no | — |
dataFormat | query | no | — |
fastaHeaderTemplate | query | no | — |
X-Request-ID | header | no | — |
downloadAsFile | query | no | boolean |
downloadFileBasename | query | no | string |
compression | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | OK | — |
500 | Internal Server Error | LapisErrorResponse |
POST/sample/alignedAminoAcidSequences/{gene}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
gene | path | yes | — |
X-Request-ID | header | no | — |
Request body
application/json — AminoAcidSequenceRequest (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | OK | — |
500 | Internal Server Error | LapisErrorResponse |
GET/sample/aminoAcidInsertions
Parameters
| Name | In | Required | Type |
|---|---|---|---|
sequenceFilters | query | no | — |
orderBy | query | no | — |
nucleotideMutations | query | no | — |
aminoAcidMutations | query | no | — |
nucleotideInsertions | query | no | — |
aminoAcidInsertions | query | no | — |
limit | query | no | — |
offset | query | no | — |
dataFormat | query | no | — |
X-Request-ID | header | no | — |
downloadAsFile | query | no | boolean |
downloadFileBasename | query | no | string |
compression | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | OK | AminoAcidInsertionsResponse |
500 | Internal Server Error | LapisErrorResponse |
POST/sample/aminoAcidInsertions
Parameters
| Name | In | Required | Type |
|---|---|---|---|
X-Request-ID | header | no | — |
Request body
application/json — InsertionsRequest (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | OK | AminoAcidInsertionsResponse |
500 | Internal Server Error | LapisErrorResponse |
GET/sample/aminoAcidMutations
Parameters
| Name | In | Required | Type |
|---|---|---|---|
sequenceFilters | query | no | — |
nucleotideMutations | query | no | — |
aminoAcidMutations | query | no | — |
minProportion | query | no | number |
orderBy | query | no | — |
limit | query | no | — |
offset | query | no | — |
dataFormat | query | no | — |
nucleotideInsertions | query | no | — |
aminoAcidInsertions | query | no | — |
fields | query | no | — |
X-Request-ID | header | no | — |
downloadAsFile | query | no | boolean |
downloadFileBasename | query | no | string |
compression | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | OK | AminoAcidMutationsResponse |
500 | Internal Server Error | LapisErrorResponse |
POST/sample/aminoAcidMutations
Parameters
| Name | In | Required | Type |
|---|---|---|---|
X-Request-ID | header | no | — |
Request body
application/json — SequenceFiltersWithMinProportion (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | OK | AminoAcidMutationsResponse |
500 | Internal Server Error | LapisErrorResponse |
GET/sample/details
Parameters
| Name | In | Required | Type |
|---|---|---|---|
sequenceFilters | query | no | — |
fields | query | no | — |
orderBy | query | no | — |
nucleotideMutations | query | no | — |
aminoAcidMutations | query | no | — |
limit | query | no | — |
offset | query | no | — |
nucleotideInsertions | query | no | — |
aminoAcidInsertions | query | no | — |
X-Request-ID | header | no | — |
dataFormat | query | no | — |
downloadAsFile | query | no | boolean |
downloadFileBasename | query | no | string |
compression | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | OK | DetailsResponse |
500 | Internal Server Error | LapisErrorResponse |
POST/sample/details
Parameters
| Name | In | Required | Type |
|---|---|---|---|
X-Request-ID | header | no | — |
Request body
application/json — DetailsPostRequest (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | OK | DetailsResponse |
500 | Internal Server Error | LapisErrorResponse |
GET/sample/mostRecentCommonAncestor
Parameters
| Name | In | Required | Type |
|---|---|---|---|
sequenceFilters | query | no | — |
phyloTreeField | query | yes | — |
printNodesNotInTree | query | no | boolean |
nucleotideMutations | query | no | — |
aminoAcidMutations | query | no | — |
dataFormat | query | no | — |
nucleotideInsertions | query | no | — |
aminoAcidInsertions | query | no | — |
X-Request-ID | header | no | — |
downloadAsFile | query | no | boolean |
downloadFileBasename | query | no | string |
compression | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | OK | MostRecentCommonAncestorResponse |
500 | Internal Server Error | LapisErrorResponse |
POST/sample/mostRecentCommonAncestor
Parameters
| Name | In | Required | Type |
|---|---|---|---|
X-Request-ID | header | no | — |
Request body
application/json — MostRecentCommonAncestorRequest (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | OK | MostRecentCommonAncestorResponse |
500 | Internal Server Error | LapisErrorResponse |
GET/sample/nucleotideInsertions
Parameters
| Name | In | Required | Type |
|---|---|---|---|
sequenceFilters | query | no | — |
orderBy | query | no | — |
nucleotideMutations | query | no | — |
aminoAcidMutations | query | no | — |
nucleotideInsertions | query | no | — |
aminoAcidInsertions | query | no | — |
limit | query | no | — |
offset | query | no | — |
dataFormat | query | no | — |
X-Request-ID | header | no | — |
downloadAsFile | query | no | boolean |
downloadFileBasename | query | no | string |
compression | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | OK | NucleotideInsertionsResponse |
500 | Internal Server Error | LapisErrorResponse |
POST/sample/nucleotideInsertions
Parameters
| Name | In | Required | Type |
|---|---|---|---|
X-Request-ID | header | no | — |
Request body
application/json — InsertionsRequest (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | OK | NucleotideInsertionsResponse |
500 | Internal Server Error | LapisErrorResponse |
GET/sample/nucleotideMutations
Parameters
| Name | In | Required | Type |
|---|---|---|---|
sequenceFilters | query | no | — |
nucleotideMutations | query | no | — |
aminoAcidMutations | query | no | — |
minProportion | query | no | number |
orderBy | query | no | — |
limit | query | no | — |
offset | query | no | — |
nucleotideInsertions | query | no | — |
aminoAcidInsertions | query | no | — |
fields | query | no | — |
X-Request-ID | header | no | — |
dataFormat | query | no | — |
downloadAsFile | query | no | boolean |
downloadFileBasename | query | no | string |
compression | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | OK | NucleotideMutationsResponse |
500 | Internal Server Error | LapisErrorResponse |
POST/sample/nucleotideMutations
Parameters
| Name | In | Required | Type |
|---|---|---|---|
X-Request-ID | header | no | — |
Request body
application/json — SequenceFiltersWithMinProportion (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | OK | NucleotideMutationsResponse |
500 | Internal Server Error | LapisErrorResponse |
GET/sample/phyloSubtree
Parameters
| Name | In | Required | Type |
|---|---|---|---|
sequenceFilters | query | no | — |
phyloTreeField | query | yes | — |
nucleotideMutations | query | no | — |
aminoAcidMutations | query | no | — |
dataFormat | query | no | — |
nucleotideInsertions | query | no | — |
aminoAcidInsertions | query | no | — |
X-Request-ID | header | no | — |
downloadAsFile | query | no | boolean |
downloadFileBasename | query | no | string |
compression | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | OK | — |
500 | Internal Server Error | LapisErrorResponse |
POST/sample/phyloSubtree
Parameters
| Name | In | Required | Type |
|---|---|---|---|
X-Request-ID | header | no | — |
Request body
application/json — PhyloSubtreeRequest (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | OK | — |
500 | Internal Server Error | LapisErrorResponse |
queries-over-time-controller3
POST/component/aminoAcidMutationsOverTime
Parameters
| Name | In | Required | Type |
|---|---|---|---|
X-Request-ID | header | no | — |
Request body
application/json — MutationsOverTimeRequest (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | OK | QueriesOverTimeResponseMutationsOverTimeResult |
500 | Internal Server Error | LapisErrorResponse |
POST/component/nucleotideMutationsOverTime
Parameters
| Name | In | Required | Type |
|---|---|---|---|
X-Request-ID | header | no | — |
Request body
application/json — MutationsOverTimeRequest (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | OK | QueriesOverTimeResponseMutationsOverTimeResult |
500 | Internal Server Error | LapisErrorResponse |
POST/component/queriesOverTime
Parameters
| Name | In | Required | Type |
|---|---|---|---|
X-Request-ID | header | no | — |
Request body
application/json — QueriesOverTimeRequest (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | OK | QueriesOverTimeResponseQueriesOverTimeResult |
500 | Internal Server Error | LapisErrorResponse |
query-controller1
POST/query/parse
Parameters
| Name | In | Required | Type |
|---|---|---|---|
X-Request-ID | header | no | — |
Request body
application/json — QueryParseRequest (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | OK | QueryParseResponse |
500 | Internal Server Error | LapisErrorResponse |
single-segmented-sequence-controller4
GET/sample/alignedNucleotideSequences
Parameters
| Name | In | Required | Type |
|---|---|---|---|
sequenceFilters | query | no | — |
orderBy | query | no | — |
nucleotideMutations | query | no | — |
aminoAcidMutations | query | no | — |
nucleotideInsertions | query | no | — |
aminoAcidInsertions | query | no | — |
limit | query | no | — |
offset | query | no | — |
dataFormat | query | no | — |
fastaHeaderTemplate | query | no | — |
X-Request-ID | header | no | — |
downloadAsFile | query | no | boolean |
downloadFileBasename | query | no | string |
compression | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | OK | — |
500 | Internal Server Error | LapisErrorResponse |
POST/sample/alignedNucleotideSequences
Parameters
| Name | In | Required | Type |
|---|---|---|---|
X-Request-ID | header | no | — |
Request body
application/json — NucleotideSequenceRequest (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | OK | — |
500 | Internal Server Error | LapisErrorResponse |
GET/sample/unalignedNucleotideSequences
Parameters
| Name | In | Required | Type |
|---|---|---|---|
sequenceFilters | query | no | — |
orderBy | query | no | — |
nucleotideMutations | query | no | — |
aminoAcidMutations | query | no | — |
nucleotideInsertions | query | no | — |
aminoAcidInsertions | query | no | — |
limit | query | no | — |
offset | query | no | — |
dataFormat | query | no | — |
fastaHeaderTemplate | query | no | — |
X-Request-ID | header | no | — |
downloadAsFile | query | no | boolean |
downloadFileBasename | query | no | string |
compression | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | OK | — |
500 | Internal Server Error | LapisErrorResponse |
POST/sample/unalignedNucleotideSequences
Parameters
| Name | In | Required | Type |
|---|---|---|---|
X-Request-ID | header | no | — |
Request body
application/json — NucleotideSequenceRequest (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | OK | — |
500 | Internal Server Error | LapisErrorResponse |
Try it
Developer reference
Base URL
https://lapis.cov-spectrum.org/open/v2Key endpoints
- GET/sample/aggregated
- GET/sample/details
Availability
Uptime100%
Median latency576.5 ms
Last checkUp · 200 · Sep 2026
Changelog
Spec versionv0
Tracked paths26
- gained an OpenAPI spec
- content changed