Geo & external context

Vendor geography and public CDC RESP-NET surveillance — shown as context only.

These endpoints back the Geo page. They attach geography at the vendor level and surface public surveillance data as context — never blended into prevalence.

Vendor profiles

GET /api/v1/geo/vendors

Returns geography/demographic profiles for laboratories: vendor_id, display_name, city, state, region, latitude, longitude, catchment_population, and notes.

cURL

curl "https://api.previq.ospri.bio/api/v1/geo/vendors"

Note

Laboratory exports don't include patient/facility geography, so locations are attached per vendor only — PrevIQ never infers a specimen's location.

Geo-joined prevalence

GET /api/v1/geo/prevalence

Vendor-level prevalence joined with vendor geography.

syndrome — string — Restrict to one syndrome.
organism — string — Restrict to one organism.
limit — integer, default: 250 — Page size, 1–5000.
offset — integer, default: 0 — Pagination offset.

Each row combines the prevalence fields with the vendor's location fields.

External sources

GET /api/v1/external/sources

Lists the external datasets PrevIQ can surface, each with a name, provider, description, denominator_note, refresh_cadence, and a status of available, planned, manual, or disabled.

CDC RESP-NET

GET /api/v1/external/cdc/resp-net

Weekly CDC respiratory hospitalization surveillance rates by state/site.

network — string, default: Combined — One of Combined, COVID-NET, FluSurv-NET, RSV-NET.

cURL

curl "https://api.previq.ospri.bio/api/v1/external/cdc/resp-net?network=FluSurv-NET"

Each row includes site, state_code, coordinates, week_ending_date, weekly_rate, cumulative_rate, unit, and a denominator_note.

Important

RESP-NET reports hospitalization rates, a different measurement than PCR panel prevalence. It is context only and is never combined into PrevIQ denominators. See Geo.