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
- Integration outputs contain listed directory records; source information and source-check status are shown when available. They do not establish 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.
Design contract · not deployed
Release notifications
The versioned webhook and subscription contracts are static design artifacts for integrator planning. There is no live signup or POST endpoint, and this project collects no subscriber, destination, contact, crisis-query, location, or behaviour data.
Available now without registration: JSON Feed, RSS, and Atom. A future managed service could add hosted delivery, retries, and operational assurance without withholding these feeds or the static data; no pricing or service-level commitment exists.
Read the release-notification design contract →Proposed design · not live
Future managed API plans
Developer Free is planned around a 100,000-unit monthly managed allowance with no card and a hard stop/no surprise bill. No signup or managed service exists; current static integrations remain free and keyless.
Review the proposed plan contract →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.