API Integrations

External data sources planned for integration with ApexHQ. Authentication and live data calls are not yet implemented — this page documents the intended data contracts.

Planned OAuth 2.0 Real-time ingestion

ApexHQ Internal Endpoints

Core monitoring API — these endpoints are live and functional.

⚡
ApexHQ Monitoring API
Internal · Express + PostgreSQL
LIVE ▼
Endpoints
REST API — /api/monitoring/*
POST/api/monitoring/ingestIngest wearable data, persist to DB, fire alerts
GET/api/monitoring/statusAll tracked expeditions
GET/api/monitoring/status/:expeditionIdSingle expedition status
GET/api/monitoring/history/:expeditionIdAltitude history (30-day window)
GET/api/monitoring/alertsRecent alert feed
GET/api/monitoring/dashboardFull dashboard snapshot
POST/api/monitoring/ll-scoreSubmit Lake Louise self-assessment
GET/api/monitoring/ll-score/:expeditionIdLL score history
GET/api/monitoring/risk-score/:expeditionIdContextualized composite risk score
POST/api/monitoring/logsSubmit user log entry
GET/api/monitoring/logs/:expeditionIdQuery logs by expedition
GET/rosterTeam roster view (DB-backed with fixture fallback)
PATCH/api/roster/:idUpdate one roster field (ll, spo2, hrv, hydration, risk, name, initials, role, thumbnail_url)

Weather & Climate Data

Environmental data sources for barometric pressure, temperature, wind, UV, and storm detection.

🌤️
OpenWeather API
OpenWeather Ltd · openweathermap.org
PLANNED ▼
AuthenticationAPI key (free tier: 1000 calls/day)
Endpointapi.openweathermap.org/data/2.5/weather?lat={lat}&lon={lon}&appid={key}
Data availableTemperature, humidity, barometric pressure, wind speed/direction, weather conditions, UV index
Refresh cadenceEvery 10 min (paid), every 60 min (free)
Use caseReal-time weather conditions, pressure trend analysis, storm detection in ApexHQ weather panel
🌎
NOAA/NWS API
National Weather Service · weather.gov
PLANNED ▼
AuthenticationNo key required · public API
Endpointapi.weather.gov/points/{lat},{lon} → gridpoint → forecast
Data availableHigh-resolution US forecast, hourly wind, precipitation, temperature, alerts, watches, warnings
Refresh cadenceUpdated every 1–2 hours
Use caseUS-based expedition weather alerts, storm watch for Everest/K2 base camps, weather advisories
🛰️
NASA POWER API
NASA Langley Research Center · power.larc.nasa.gov
PLANNED ▼
AuthenticationNo key required · public API
Endpointpower.larc.nasa.gov/api/v2/data/7?parameters=ALLSKY_SFC_SW_DNI,CLRSKY_SFC_SW_DIFF,T2M,RH2M,PS,U50M,V50M,PRECTOTCORR&community=RE&longitude={lon}&latitude={lat}&start=YYYYMMDD&end=YYYYMMDD&format=JSON
Data availableSolar radiation (DNI, diffuse), temperature, humidity, surface pressure, wind vectors, precipitation. Climate normal data back to 1984.
Refresh cadenceMonthly aggregation; historical and climate normal data
Use caseSolar gain calculations at high altitude, climate context for long expeditions, solar-powered gear recommendations

Wearable & Activity Integrations

Live biometric and activity data from fitness trackers, smartwatches, and health platforms.

🏃
Strava API
Strava, Inc. · strava.com
PLANNED ▼
AuthenticationOAuth 2.0 · athlete activity data
Endpointwww.strava.com/api/v3/activities?per_page=200&page={page}
Data availableElevation gain/loss, distance, pace, heart rate (with HR monitor), moving time, grade-adjusted pace
Refresh cadenceOn-demand · athlete syncs activity post-hike
Use caseActivity log enrichment in ApexHQ user_logs (ascent rate, daily distance), climb-day verification
⌚
Garmin Health API
Garmin International · developer.garmin.com
PLANNED ▼
AuthenticationOAuth 2.0 (Garmin Health) · partner approval required
Endpointgarmin.com/health/ecosystem/d GARMIN Health API · DIZ API for summary data
Data availableSpO2, heart rate, HRV (Garmin HRM), sleep stages, stress, training load, recovery time, body battery
Refresh cadenceDaily summaries + real-time via Garmin Live API (paid tier)
Use casePrimary source for SpO2, HRV, sleep data in the contextualized risk engine. Most relevant for Garmin Fenix/Instinct users on expeditions.
🍎
Apple HealthKit
Apple Inc. · developer.apple.com/healthkit
PLANNED ▼
AuthenticationHealthKit entitlements (iOS app) · HKHealthStore API
Data availableSpO2, heart rate, HRV (via Apple Watch), sleep analysis, respiratory rate, VO2 max, nutrition (calories, water, macros), activity
Refresh cadenceReal-time via HKObserverQuery + HKAnchoredObjectQuery
PlatformiOS app required · HealthKit is not available via web APIs
Use caseiPhone/Apple Watch users — SpO2, HRV, sleep, nutrition logs. Highest data quality for Apple Watch Ultra users on expeditions.
📱
Google Fit API
Google Cloud · developers.google.com/fit
PLANNED ▼
AuthenticationOAuth 2.0 · Fitness API scopes
Endpointwww.googleapis.com/fitness/v1/users/me/dataset:aggregate
Data availableHeart rate, SpO2 (via Samsung/Withings), step count, distance, sleep, nutrition (calories, water), activity sessions
Refresh cadenceHistorical queries via dataset aggregate · real-time via History API
Use caseAndroid Wear / Samsung Galaxy Watch users — HR, SpO2, nutrition logs. SpO2 coverage varies by device.

Elevation & Terrain Data

Altitude lookup and terrain data for GPS coordinates — used to cross-reference barometric readings with geographic altitude.

⛰️
Open-Elevation API
Open-Elevation · open-elevation.com
PLANNED ▼
AuthenticationAPI key · self-hosted option available
Endpointapi.open-elevation.com/api/v1/lookup?locations={lat},{lon}|...
Data availableElevation in meters for any lat/lon pair. Global coverage via SRTM data.
Refresh cadenceStatic data — no refresh needed
Use caseCross-validate barometer altitude readings. Verify GPS altitude against known terrain. Compute gain/loss per day from map-referenced waypoints.
🌊
GEBCO + HydroSHEDS
GEBCO / USGS · gebco.net · hydrosheds.org
PLANNED ▼
AuthenticationNo key for GEBCO · USGS requires registration for bulk
Data availableBathymetry (ocean floor), terrain elevation, watershed boundaries, flow accumulation, river networks
FormatGeoTIFF, NetCDF · requires spatial query logic
Use caseTerrain difficulty scoring for approach routes. River crossing hazard assessment for multi-terrain expeditions. High-resolution elevation models for base camp planning.