---
title: "Get helplines for a specific country"
method: GET
path: "/crisis_helplines"
tags: ["Helplines"]
---

# Get helplines for a specific country

`GET /crisis_helplines`

## Request

- Base URL: `https://helpline-api.koko.ai`
- URL: `https://helpline-api.koko.ai/crisis_helplines`
- Auth: none required

Returns an array of crisis helplines for the specified country. The country parameter accepts both full country names and aliases (e.g., "USA", "America" for "United States").

## Response Patterns
- Returns empty array `[]` if country has no helplines or is unknown
- Returns 400 error if country parameter is missing
- Returns 403 error if request origin is not allowed (CORS)

## Query parameters

- `country` string, required

## Response `200`

Successfully retrieved helplines for the specified country

- Helpline[]
  - `country` string, required: Full country name where this helpline operates
  - `countryI18nKey` string, required: Internationalization key for the country (typically locale code)
  - `countryCode` string, required: ISO 3166-1 alpha-2 country code
  - `name` string, required: Name of the helpline organization or service
  - `description` string, required: Brief description of the services provided
  - `url` string, uri, required: Full URL to the helpline's website
  - `displayURL` string: Human-friendly display version of the URL (without protocol)
  - `phone` string, required: Raw phone number or short code
  - `displayNumber` string, required: Phone number formatted for display purposes
  - `formattedCallNumber` string, required: Phone number formatted for tel: links (calling)
  - `formattedTextingNumber` string, required: Phone number formatted for sms: links (texting)
  - `displayTextNumber` string: Text message number formatted for display
  - `availability` string, required: Human-readable availability description **Common values:** - `24/7` - Available around the clock - `Business hours` - Standard business hours only - Custom schedules (e.g., "Mon-Fri 9am-5pm")
  - `modality` 'phone' | 'text' | 'chat' | 'email', required: Primary contact method for this helpline **Common values:** - `phone` - Voice call support - `text` - SMS/text message support - `chat` - Online chat support - `email` - Email support
  - `identity` string, required: Target demographic or identity group for this helpline **Examples:** - `general` - Available to everyone - `youth` - Specifically for young people - `lgbtq` - LGBTQ+ focused - `veterans` - Military veterans - `indigenous` - Indigenous/native populations
  - `topic` string, required: Primary topic or issue area addressed by this helpline **Examples:** - `crisis` - General crisis support - `suicide` - Suicide prevention - `domestic_violence` - Domestic violence support - `substance_abuse` - Addiction and substance abuse - `mental_health` - Mental health support
  - `topicMenu` boolean, required: Whether this helpline should appear in topic-based filtering menus Used for UI/UX to determine which helplines to show in categorized views.
  - `hours` string: Detailed hours of operation (may duplicate availability field)

## Other responses

- `400`: Bad request - missing required country parameter
- `403`: Forbidden - Origin not allowed (CORS error)

---

[API](https://skmtc.dev/kokocares/apis/crisis-helplines-api.md) - [All operations](https://skmtc.dev/kokocares/apis/crisis-helplines-api/llms.txt) - [OpenAPI document](https://skmtc.dev/kokocares/apis/crisis-helplines-api/revisions/49b8b181fc23?raw)