Contribute Data

How to add a helpline

1. Fork the repository on GitHub
2. Find or create the file at data/countries/[country-code]/helplines.json
3. Add your helpline using the JSON schema format (see example below)
4. Open a pull request — we review and merge quickly

JSON Format

{
  "$schema": "../../../schemas/helpline.schema.json",
  "country": "XX",
  "records": [
    {
      "id": "xx-helpline-name",
      "country": "XX",
      "name": "Crisis Helpline Name",
      "category": "suicide_prevention",
      "contacts": [
        {
          "method": "phone",
          "number": "+1-800-xxx-xxxx",
          "languages": ["en"],
          "hours": "24/7",
          "free": true,
          "anonymous": true
        }
      ],
      "description": "Brief description of the service.",
      "website": "https://example.org",
      "verified_at": "2026-06-02",
      "source": "https://example.org",
      "government_backed": false
    }
  ]
}

Guidelines

• One helpline per record (no aggregated listings)
• Verify phone numbers and URLs before submitting
• Include accurate operating hours (24/7 or specific times)
• Use ISO 3166-1 alpha-2 country codes (e.g., “JP”, “US”)
• Use BCP 47 language codes (e.g., “en”, “ja”, “es”)
• Data must be factual and verifiable — no promotional content