Public static beta
Choose the smallest safe integration
The finder, API v1, widget v1, and downloads are free to access without an account or API key. They have no uptime, support, or SLA commitment.
Integration choices
Link to the finder
Send people to the maintained interface. This is the least complex choice.
Open finder →Static API v1
Fetch versioned country artifacts and run the deterministic resolver locally.
Open API manifest →Direct snapshot
Inspect the canonical branch snapshot directly. Prefer API v1 when you need a versioned contract.
Open hotlines.json ↗Copy/paste widget
<script src="https://worldhotlines.org/widget/v1/hotlines-widget.js" defer></script>
<world-emergency-hotlines country="us" category="mental_health" max-results="6"></world-emergency-hotlines>Allow the production origin in your CSP script-src and connect-src. See the complete widget guide ↗.
Current limitations
- Records are source-backed directory entries, not live availability, medical advice, eligibility, clinical suitability, or outcome guarantees.
- Verification status describes recorded evidence; numbers, hours, services, and official guidance can change.
- Resolver scope and fallback are conservative. Integrators must preserve their explanations and handle network, empty, and malformed-response states.
- All surfaces are static beta and provide no uptime, support, response, or verification SLA.
Privacy by design
Static artifacts and local resolution avoid sending locality, need, or channel selections to this project. No API key, third-party cookie, or user-identifying analytics are required, and this repository does not implement integration telemetry. Any future technical-health counters require customer-boundary aggregation and qualified privacy/legal review. Keep sensitive values out of URLs, logs, attributes, and analytics.