shipapis
StarSubmit an APISubmit API

LAPIS

Query aggregated SARS-CoV-2 genomic sequence data

🩺 Health & FoodHEALTHYchecked 54 min ago
AUTH NONECORS ✓AGENT ✓HTTPS ✓COMMERCIAL ?

LAPIS (from CoV-Spectrum/GenSpectrum) serves aggregated statistics over open SARS-CoV-2 sequences — filter by mutation, lineage, date, or location and get counts back. This open instance needs no key and returns JSON, handy for genomic-epidemiology dashboards.

95HOW IT'S SCORED ⓘ
▶ Run liveDocs ↗
Status badge · for your READMEshipapis health badge: 95 · healthy
Uptime history
100%90 days
100%30 days
524P50 · ms
846P95 · ms
operationalpartialdownno data
Response time · last 48 checks
Fastest 48 ms, slowest 841 ms, most recent 192 ms.
Live response samplecaptured by our last successful check
GET https://lapis.cov-spectrum.org/open/v2/sample/aggregated

{
  "data": [
    {
      "count": 9429218
    }
  ],
  "info": {
    "dataVersion": "1782923445",
    "lapisVersion": "0.8.3"
  }
}
Call itcurl · fetch · python
curl "https://lapis.cov-spectrum.org/open/v2/sample/aggregated"
const res = await fetch("https://lapis.cov-spectrum.org/open/v2/sample/aggregated");
const data = await res.json();
console.log(data);
import requests

res = requests.get("https://lapis.cov-spectrum.org/open/v2/sample/aggregated")
print(res.json())
Endpoints · 6HealthyFULL DOCS ↗
Monitored path responding — GET /sample/aggregated524 mschecked 54 min ago
GET/sample/aggregatedPROBED

Query aggregated SARS-CoV-2 genomic sequence data

GET/sample

Sample — documented GET route.

GET/sample/1

Sample details by ID (example: 1).

GET/sample?limit=10

Sample — documented GET route.

GET/sample/search?q=test

Search by query parameters.

GET/sample/unalignedNucleotideSequences

Returns a string of unaligned nucleotide sequences. Only sequences matching the specified sequence filters are considere

Machine-readable spec

We probe a documented GET and expect 2xx JSON — full uptime and health score. Export includes every documented route below.

Response-shape history

Stable. No schema drift observed since monitoring began — the response shape has not changed under our checks.

LAPIS: common questions

Is LAPIS free to use?

Yes — LAPIS is a free health & food API. Free tier: Free — no key (open instance). Whether the free tier allows commercial use is unclear — check the provider docs.

Does LAPIS need an API key?

No — LAPIS needs no API key or signup. You can call it straight away; rate limits still apply (Unpublished).

Can I call LAPIS from the browser?

Yes — LAPIS returns CORS headers over HTTPS, so front-end code can fetch it directly with no backend proxy. Use the fetch snippet on this page, or hit "Run live" to try it now.

Is LAPIS up right now?

As of our last scheduled check, LAPIS is healthy with 100% uptime over 90 days and a 524 ms median response. We re-probe it every sweep — the status badge and uptime chart above always show the latest.