🚧 The EHSPI live link will be updated shortly. In the meantime, reach us at ops@exposomic.ai
Use cases

One API. Four integration patterns. Real scenarios, real endpoints.

vasus.ai serves four primary integration patterns. Each scenario below describes the specific problem, the API integration, and the outcome — grounded in what the API actually returns today.

Digital Health App Health Insurer Research Institution Employee Wellbeing
📱
Digital Health App

Condition management apps

Add an evidence-based environmental risk layer to further personalise user daily check-ins — without building the science.

1 API call
Enrich the user experience with risk level, signals, synthesis paragraph, and inline citations tailored to their condition
The problem

Users of condition management apps — migraine trackers, asthma diaries, sleep apps — already log their symptoms. But they have no in-depth way to connect what happened environmentally to what they experienced. The app captures the outcome. It can have no or minimal visibility into the trigger and science behind it.

The solution

vasus.ai adds environmental context to every check-in. Each morning, the app calls POST /v1/insight with the user's home location and condition specifics like subtype, trigger and time to onset. The response includes a risk level, the three most relevant environmental signals, a synthesis paragraph grounded in peer-reviewed evidence, and cited recommendations — all in one structured JSON response that can merged with existing user attributes

The outcome

Users see "Moderate migraine risk today — barometric pressure dropped 6.2 mb overnight" with two citations, not just a weather widget. The app becomes clinically meaningful, building trust and traction with users, without the product team building any environmental science. Users experience a more personalised app experience and app teams gain deeper insight into what information connects best with their users.

Integration steps
1
On app open or daily check-in
POST /v1/insight with condition + stored home location + window=24
2
Display risk chip in dashboard
risk_level from response. Green/amber/red badge. No custom logic needed.
3
Surface synthesis paragraph
summary field. Plain English. Cite the top_matches citations inline.
4
Optional: enable push alerts
POST /api/alert/subscribe once. Hourly monitor fires Web Push when threshold met.
Relevant sensitivities
migraine respiratory cardiovascular sleep allergies
Relevant for: migraine tracker apps, asthma management apps, COPD management, sleep quality apps, pollen allergy apps.
Try it live ↗ Discuss this integration →
🏥
Health Insurer

Population environmental risk monitoring

Monitor environmental health burden across member cohorts by city — and act before claims arrive.

20 cities
Pre-seeded with nightly EHSPI composite and per-sensitivity scores
The problem

Insurers have extensive claims data but no forward-looking environmental signal. They know what happened — high claim volumes in summer in Delhi, elevated asthma hospitalisations in London during pollen season — but cannot systematically anticipate it or act proactively. The missing data layer is real-time environmental health intelligence at city level.

The solution

The EHSPI API provides daily composite and per-sensitivity environmental health scores for 22 global cities. Call GET /v1/ehspi nightly to pull the full city cohort. Build a dashboard that flags cities where EHSPI composite or a specific sensitivity score falls below a threshold — triggering proactive member outreach, preventative care programme activation, or underwriting alerts.

The outcome

Environmental health risk becomes a structured data input to population health management — not an afterthought. Actuarial teams can correlate EHSPI trajectories with historical claim patterns. Member engagement teams can send targeted communications when environmental burden is elevated in a member's city.

Integration steps
1
Nightly EHSPI pull
GET /v1/ehspi?sensitivity=all&mode=lifetime — all 20 cities, all 5 sensitivities, composite scores
2
Store in your data warehouse
The response is structured JSON. Pipe to BigQuery, Redshift, or Snowflake alongside claims data.
3
Threshold alerting
Flag cohorts where EHSPI drops below your defined threshold. API returns confidence level per city.
4
Historical trend analysis
GET /v1/ehspi/history for longitudinal analysis. Correlate EHSPI trajectory with historical claim patterns.
Relevant sensitivities
respiratory cardiovascular allergies sleep migraine
Relevant for: health insurers, population health management platforms, employee health benefit programmes, occupational health providers.
Try it live ↗ Discuss this integration →
🔬
Research Institution

Longitudinal environmental exposure studies

Structured daily environmental health scores across 20 cities — ready for correlation with clinical outcome data.

90+ days
Data history per city, growing daily. High confidence tier reached at 90 days.
The problem

Environmental health researchers often have excellent clinical outcome data but no structured, comparable environmental exposure data across multiple cities and time periods. Building that data infrastructure — ingesting from 7 API sources, computing features, normalising signals across cities — is a significant engineering investment that sits outside the core research competence.

The solution

vasus.ai's EHSPI history endpoint provides a clean, structured daily time series of environmental health scores across 20 cities for up to 5 sensitivities. All weight vectors are published transparently — any paper using EHSPI data can fully describe the scoring methodology. The Google Environmental API Spot Study (in progress) will provide validation data comparing API outputs against independent reference networks.

The outcome

Research teams can access a structured, validated environmental exposure dataset without building the data infrastructure. The published weight vectors enable methodological transparency in any resulting publication. Collaboration on the formal EHSPI validation study is actively welcomed.

Integration steps
1
Pull historical EHSPI scores
GET /v1/ehspi/history?tile_id=...&days=365 for each city of interest. Daily composite + 5 sensitivity scores.
2
Pull raw signal trends
GET /v1/trends?sensitivity=...&tile_id=...&window=90d for individual signal time series (PM2.5, pressure volatility, pollen load, etc.).
3
Match to clinical data
EHSPI dates align to UTC calendar days. Match to clinical outcome timestamps. Lagged analysis supported.
4
Reference the methodology
Cite weight vectors from /research. Full transparency — no black box. Collaboration on validation welcomed.
Relevant sensitivities
migraine respiratory cardiovascular sleep allergies
Relevant for: environmental epidemiology groups, chronic disease research centres, public health institutes, clinical trial teams studying environmental confounders.
Try it live ↗ Discuss this integration →
🏢
Employee Wellbeing

Workforce environmental health programmes

Give employees with chronic conditions evidence-based environmental awareness — without storing any health data.

Zero PII
No user profiles, no health records, no accounts. Session token only.
The problem

Employers running employee wellbeing programmes want to support employees with chronic conditions but face a fundamental constraint: they cannot collect health data. Any tool that requires employees to disclose their condition to their employer creates legal and trust risk. Existing environmental health tools are either too generic (weather apps) or require personal health profiling.

The solution

vasus.ai's architecture is privacy-first by design. Employees interact with the tool anonymously — no account, no health record, no PII of any kind. They choose their condition sensitivity privately. The API receives a condition key and a location string, returns an intelligence output, and stores nothing about the individual. The employer never sees who chose which condition.

The outcome

Employees with migraines, asthma, cardiovascular conditions, or allergies get daily environmental context relevant to their condition — served through a white-labelled integration or the consumer SPA — without the employer ever knowing which conditions are being checked. The privacy architecture is a competitive differentiator for enterprise deployment.

Integration steps
1
White-label or deep link
Embed a link to app.vasus.ai?sensitivity=X in the employee wellbeing portal — or build a white-labelled wrapper using the API.
2
No health data collected
The API requires only a location string and a condition key. No employee ID, no health record, no PII. Employer sees aggregate stats only.
3
City-level EHSPI dashboards
For distributed workforces: pull EHSPI scores for office city locations. Surface environmental health context at team or office level.
4
Optional push alerts
Employees can subscribe to push alerts on their personal device. The subscription is tied to their device session — never to their employee profile.
Relevant sensitivities
migraine respiratory sleep allergies cardiovascular
Relevant for: employee wellbeing platforms, occupational health providers, HR technology vendors, corporate health benefit administrators.
Try it live ↗ Discuss this integration →

Which endpoints each use case relies on

Use case POST /v1/insight GET /v1/ehspi GET /v1/ehspi/history GET /v1/trends POST /api/alert/subscribe
Condition management app
Health insurer
Research institution
Employee wellbeing