PrevIQ Docs

Catalog & health

Liveness check and the entity lists that power filters and dropdowns.

These lightweight endpoints power the app's filters and let you discover what's in the dataset.

Health check

GET /api/v1/health

A cheap liveness probe that doesn't touch the database.

Response

{
  "status": "ok",
  "service": "previq-api",
  "version": "0.1.0",
  "timestamp": "2026-05-29T20:11:04Z"
}

List syndromes

GET /api/v1/syndromes

Returns every syndrome present in the database (envelope of strings).

cURL

curl "https://api.previq.ospri.bio/api/v1/syndromes"

Response

{ "data": ["GI", "RESPIRATORY", "STI", "UTI", "VAGINOSIS", "WOUND"], "meta": { "total": 6, "limit": 0, "offset": 0, "query": {} } }

List vendors

GET /api/v1/vendors

Returns every laboratory (vendor ID) present in the database.

Response

{ "data": ["AFC", "OBG-YN", "HUC"], "meta": { "total": 3, "limit": 0, "offset": 0, "query": {} } }

List organisms

GET /api/v1/organisms

Returns every canonical organism name present, sorted alphabetically.

List panels

GET /api/v1/panels

Returns every normalized panel name present (excludes the synthetic ALL panel). Powers the Explore page's panel filter.

Note

All four list endpoints return the standard { data, meta } envelope with data as an array of strings. They take no query parameters.