Public developer documentation
Children's Early Warning — developer documentation
Open technical reference for anyone integrating with Children's Early Warning public APIs and data — thresholds, modules, and endpoints. Schools, clinics, and community users should use the product UI for day-to-day early action.
Product UI
Facility risks & playbooks
Public status
Live facility & station metrics
System markdown
OSS module overview on GitHub
Open-source modules
facility-registry
GPS-mapped schools and clinics with enrollment/catchment
child-thresholds
Watch / warning / critical rules for schools vs clinics
heat-illness-predictor
Classical heat-illness risk score (0–100) + 7-day outlook
vector-suitability
Malaria/vector climate suitability (not clinical diagnosis)
station-telemetry
School/clinic weather & AQ station readings
public-apis
Internet-accessible JSON APIs for dashboards and partners
Core libraries live under src/lib/early-warning/. See also LICENSE (MIT) and docs/EARLY_WARNING_V1.md.
Public API endpoints
All listed routes return JSON. Public read endpoints require no auth. Base host: your deployment origin (e.g. https://www.kibiraai.com).
API index — endpoint catalog and product description
Public metrics: facilities, stations, alert counts, modules
Facility registry (schools & clinics). Query: type, ward, district, risk=1
Live risk, alerts, 7-day outlook, and station telemetry for one facility
Child-sensitive watch / warning / critical thresholds + playbooks
Heat-illness and vector suitability. Query: facilityId | lat,lng | batch
Weather/AQ stations at schools and clinics. Query: id, status, live=0
# Example
curl https://www.kibiraai.com/api/early-warning/status
curl https://www.kibiraai.com/api/early-warning/facilities/sch-kawempe-primary
curl "https://www.kibiraai.com/api/early-warning/predictions?facilityId=sch-bwaise-muslim"
Child-sensitive thresholds
Levels: normal → watch → warning → critical. Version 1.0.0.
| Hazard | Watch | Warning | Critical |
|---|
Machine-readable copy: GET /api/early-warning/thresholds
Integration notes
- Classical models drive heat-illness and vector suitability scores; GenAI (if used) is advisory only and does not trigger alerts by itself.
- Scores are climate / hazard foresight for facilities — not clinical diagnoses or individual child health records.
- Roadmap interoperability: FHIR / DHIS2 mapping planned; current surface is these public JSON APIs.
- PII (adult contacts for SMS/WhatsApp) is proprietary and not exposed on public endpoints.
Product experience for schools & clinics: /childrens-early-warning