Dataset & downloads

The full dataset is publicly accessible and downloadable. All data is served as static JSON — no API key needed. Public access is separate from permission to reuse it; review the licensing status below.

Last built: August 13, 2026 · Schema version: 2.0 ·250 countries · 3,255 hotlines

Versions and stable IDs

Every hotline record has an opaque, immutable id. Names and contact details can be corrected without changing that identity. Generated manifests and country shards expose a dataset_versioncalculated from the exact canonical dataset used for the build. Use it for cache keys and audit evidence;generated_at only records build time.

sha256:e893c9f6b0afcc57832054547002c826e80b5387e544b4cf6909afc9424dde3a

Static API v1

Versioned read-only artifacts provide stable record lookup, per-country routing inputs, and the same explainable resolver used by the guided finder. Resolution can run in the consuming browser without sending locality or need selections to this site. This is a static API; there is no hosted query endpoint.

API manifest Widget demo Developer guide

Metadata coverage, without a quality score

The deterministic coverage report keeps field presence, geography specificity, field-level evidence, verification dates, and structured-scope adoption separate. A populated legacy field is not proof that a claim is current or source-backed, and missing metadata does not mean a service is unavailable or unsuitable.

View metadata coverage JSON

Static JSON files

All files are served from /data/ on this site and can be fetched directly. Cross-origin requests are supported (CORS open).

manifest.json(~210 KB)

Download ↗

Index of all countries with hotline counts, verified counts, category lists, channel flags, and geographic centroids.

categories-stats.json(~5 KB)

Download ↗

Global per-category aggregates: hotline count, country count, verified count.

metadata-coverage.json(~5 KB)

Download ↗

Separate metadata-presence, geography-specificity, field-evidence, verification-freshness, and structured-scope adoption metrics. This is not a service-quality or availability score.

search-index.json(~910 KB)

Download ↗

Flattened array of all hotlines with lightweight search fields: names, numbers, category, languages, verification status, channel flags. Used by the in-browser search.

countries/{alpha2}.json(1–100 KB each)

per-country

Individual country shards with full hotline records. Example: /data/countries/us.json, /data/countries/gb.json. Use manifest.json to enumerate all 250 country codes.

Data structure

Hotline fields

{
  "id": "weh_...",
  "name": "string",
  "organization": "string | null",
  "category": "suicide_crisis | mental_health | domestic_violence | ...",
  "voice_numbers": ["string"],
  "sms_numbers": ["string"],
  "text_numbers": ["string"],
  "short_codes": ["string"],
  "chat_url": "string | null",
  "email": "string | null",
  "website": "string | null",
  "hours": "string | null",
  "languages": ["string"],
  "cost": "free | local_rate | premium | unknown",
  "target": "string | null",
  "geography": "string | null",
  "notes": "string | null",
  "verification_status": "verified_web | verified_authority | verified_knowledge | cross_referenced | legacy_unverified | disputed | deprecated",
  "last_verified": "YYYY-MM-DD | null",
  "sources": ["url"],
  "replaced_by": "weh_... | null"
}

Verification statuses explained

verified_web: A maintainer recorded an observation from the organisation's public website; this is not a test call or availability check.
verified_authority: A maintainer recorded evidence from a government or other responsible authority; current operation is not guaranteed.
verified_knowledge: A maintainer recorded evidence from a cited reference; current operation is not guaranteed.
cross_referenced: Found in multiple sources but not observed from the provider or responsible authority. Check current official guidance.
legacy_unverified: From an earlier dataset without a current source observation. Check official guidance before relying on it.
disputed: Conflicting information found across sources. Treat with caution.
deprecated: Service is believed to have closed or changed number. Included for historical reference.

Canonical source

The authoritative dataset lives in hotlines.json at the root of the GitHub repository. The JSON shards served here are generated from it at build time. Use the separate public forms for a listing correctionor provider/new service. Do not submit sensitive personal data. Submissions are review leads; publication is not guaranteed.

GitHub repository ↗Correct a listing ↗

Usage

These files are publicly accessible, but this repository currently has no license. Public accessibility does not itself grant reuse rights. Before production reuse, review the repository licensing status and obtain or confirm the permission you need. Crisis data has real-world impact: preserve accuracy and verification context.