---
title: /v1/helplines
slug: v1helplines
docTags: 
createdAt: 2026-05-06T23:35:31.392Z
---

{
  "id": "ulkWpvaUHkA6Zel6JuT7u",
  "type": "api-oas-v2",
  "data": {
    "method": "GET",
    "url": "https://api.throughlinecare.com/v1/helplines",
    "description": "Lists the available verified helplines in a given country. Helplines will be listed in an optimal order using our intelligent ranking algorithm.",
    "contentType": "application/json",
    "request": {
      "pathParameters": [],
      "headerParameters": [
        {
          "name": "accept",
          "type": "string",
          "kind": "optional",
          "description": "Generated from available response content types",
          "enum": [
            "application/json"
          ],
          "default": "application/json"
        }
      ],
      "queryParameters": [
        {
          "kind": "required",
          "name": "country_code",
          "type": "string",
          "description": "<p>The ISO 3166 Alpha-2 code for the country to retrieve helplines for e.g 'us'.</p>"
        },
        {
          "kind": "optional",
          "name": "topic",
          "type": "string",
          "description": "<p>Optional parameter that filters the helplines based on topic e.g. 'Suicidal thoughts'. All helplines which indicate they support this topic (in addition to others) will be included in the results.</p>"
        },
        {
          "kind": "optional",
          "name": "specialty",
          "type": "string",
          "description": "Optional parameter that filters the helplines based on specialty e.g. 'Youth'. All helplines which indicate they support this specialty will be included in the results."
        },
        {
          "kind": "optional",
          "name": "contact_method",
          "type": "string",
          "description": "<p>Optional parameter that filters the helplines based on the supported contact methods e.g. \"phone\". Only helplines which indicate they support this contact method will be included in the results. Supported values are \"phone\", \"chat\", \"sms\", \"whatsapp\", and \"tty\".</p>"
        },
        {
          "kind": "optional",
          "name": "limit",
          "type": "integer",
          "description": "Optional parameter that specifies the maximum number of helplines to return.",
          "default": 20,
          "format": "int32",
          "minimum": 1,
          "maximum": 100
        },
        {
          "kind": "optional",
          "name": "priority_only",
          "type": "boolean",
          "description": "<p>When true, returns only manually curated priority services for the specified topic. Currently only supporting 'Suicidal thoughts' topic.</p>",
          "default": false
        }
      ],
      "bodyDataParameters": [],
      "formDataParameters": [],
      "oAuthParameters": [
        {
          "id": "bearerAuth",
          "name": "Authorization",
          "kind": "optional",
          "type": "apiKey",
          "description": "<p>Enter the token with the \"Bearer: \" prefix e.g. \"Bearer ABC...\"</p>",
          "in": "header"
        }
      ]
    },
    "responses": [
      {
        "statusCode": "200",
        "description": "Lists the available verified helplines in a given country. Helplines will be listed in an optimal order using our intelligent ranking algorithm.",
        "jsonExample": "",
        "isExpanded": true,
        "schema": [
          {
            "kind": "optional",
            "type": "object",
            "description": "Lists the available verified helplines in a given country. Helplines will be listed in an optimal order using our intelligent ranking algorithm.",
            "schema": [
              {
                "name": "helplines",
                "kind": "optional",
                "type": "array",
                "description": "",
                "modelRef": "#/definitions/HelplineV1",
                "customType": "HelplineV1[]",
                "schema": [
                  {
                    "name": "id",
                    "kind": "required",
                    "type": "string",
                    "description": "The unique identifier for the helpline.",
                    "example": "crisis-text-line"
                  },
                  {
                    "name": "name",
                    "kind": "required",
                    "type": "string",
                    "description": "Official name of the helpline in the native language.",
                    "example": "Crisis Text Line"
                  },
                  {
                    "name": "description",
                    "kind": "optional",
                    "type": "string",
                    "description": "Description of the service provided by the helpline in English.",
                    "example": "Crisis Text Line is here to help you, whatever you're going through. We provide 24/7, free and confidential support and information by text message (text HOME to 741-741), online chat and WhatsApp (+1-443-787-7678). We are available to talk with you about any kind of experience relating to mental health, including anxiety, depression, self-harm, stress, and thoughts of suicide."
                  },
                  {
                    "name": "shortDescription",
                    "kind": "optional",
                    "type": "string",
                    "description": "A concise summary of the service provided by the helpline in English.",
                    "example": "24/7 free crisis support for youth in NZ"
                  },
                  {
                    "name": "website",
                    "kind": "optional",
                    "type": "string<uri>",
                    "description": "Primary website of the service.",
                    "example": "https://www.crisistextline.org/",
                    "format": "uri"
                  },
                  {
                    "name": "country",
                    "kind": "required",
                    "type": "object",
                    "description": "",
                    "complexType": "allOf",
                    "complexItems": [
                      {
                        "name": "Country",
                        "description": "",
                        "modelRef": "#/definitions/Country",
                        "schema": [
                          {
                            "name": "name",
                            "kind": "required",
                            "type": "string",
                            "description": "English language name for the country.",
                            "example": "New Zealand"
                          },
                          {
                            "name": "code",
                            "kind": "required",
                            "type": "string",
                            "description": "<p>ISO 3166 Alpha-2 code for the country.</p>",
                            "example": "nz"
                          },
                          {
                            "name": "emergencyNumber",
                            "kind": "optional",
                            "type": "string",
                            "description": "Emergency services phone number. Only available for countries where suicide is not a illegal.",
                            "example": "111"
                          }
                        ]
                      }
                    ],
                    "schema": []
                  },
                  {
                    "name": "timezone",
                    "kind": "required",
                    "type": "string",
                    "description": "The timezone where this helpline operates.",
                    "example": "America/Los_Angeles"
                  },
                  {
                    "name": "topics",
                    "kind": "required",
                    "type": "array",
                    "description": "A collection of topics which the helpline supports.",
                    "example": "",
                    "itemType": "string",
                    "customType": "string[]",
                    "itemExample": "",
                    "itemDefault": ""
                  },
                  {
                    "name": "supported_languages",
                    "kind": "required",
                    "type": "array",
                    "description": "A collection of ISO language codes that the helpline supports.",
                    "example": "[\"en\",\"es\",\"fr\"]",
                    "itemType": "string",
                    "customType": "string[]",
                    "itemExample": "",
                    "itemDefault": ""
                  },
                  {
                    "name": "specialties",
                    "kind": "required",
                    "type": "array",
                    "description": "<p>Specialties categorize services by audience demographics, identity groups, and specific service needs.</p>",
                    "example": "",
                    "itemType": "string",
                    "customType": "string[]",
                    "itemExample": "",
                    "itemDefault": ""
                  },
                  {
                    "name": "supportTypes",
                    "kind": "optional",
                    "type": "array",
                    "description": "<p>A collection listing the qualification of the people who provide support at the helpline. e.g. Counselors, Volunteers, Peers, etc. Only available for Full tier applications</p>",
                    "example": "",
                    "itemType": "string",
                    "customType": "string[]",
                    "itemExample": "",
                    "itemDefault": ""
                  },
                  {
                    "name": "hours",
                    "kind": "optional",
                    "type": "object",
                    "description": "",
                    "complexType": "allOf",
                    "complexItems": [
                      {
                        "name": "Hours",
                        "description": "",
                        "modelRef": "#/definitions/Hours",
                        "schema": [
                          {
                            "name": "alwaysOpen",
                            "kind": "required",
                            "type": "boolean",
                            "description": "<p>Indicates if the helpline is always open. If true, the periods field will be empty. If false, the periods field will contain the opening hours for the helpline.</p>"
                          },
                          {
                            "name": "periods",
                            "kind": "required",
                            "type": "array",
                            "description": "<p>A collection of periods representing the opening hours for the helpline. Only available if always_open is false.</p>",
                            "modelRef": "#/definitions/Period",
                            "customType": "Period[]",
                            "schema": [
                              {
                                "name": "day",
                                "kind": "required",
                                "type": "integer<int32>",
                                "description": "<p>An integer representation of the day of the week that the period applies to. Days are index from 1, with Monday=1, Tuesday=2, through to Sunday=7.</p>",
                                "example": "1",
                                "format": "int32"
                              },
                              {
                                "name": "open",
                                "kind": "required",
                                "type": "string<time>",
                                "description": "The time the helpline opens on the given day.",
                                "example": "09:00",
                                "format": "time"
                              },
                              {
                                "name": "close",
                                "kind": "required",
                                "type": "string<time>",
                                "description": "The time the helpline closes on the given day.",
                                "example": "17:00",
                                "format": "time"
                              }
                            ]
                          }
                        ]
                      }
                    ],
                    "schema": []
                  },
                  {
                    "name": "phoneNumber",
                    "kind": "optional",
                    "type": "string",
                    "description": "Phone number that people in crisis can call.",
                    "example": "1-800-555-1212"
                  },
                  {
                    "name": "smsNumber",
                    "kind": "optional",
                    "type": "string",
                    "description": "SMS number that people in crisis can txt.",
                    "example": "741741"
                  },
                  {
                    "name": "webChatUrl",
                    "kind": "optional",
                    "type": "string<uri>",
                    "description": "URL that people in crisis can use to start an online chat.",
                    "example": "https://connect.crisistextline.org/chat?utm_source=findahelpline",
                    "format": "uri"
                  },
                  {
                    "name": "whatsappUrl",
                    "kind": "optional",
                    "type": "string<uri>",
                    "description": "WhatsApp URL that people in crisis can use to start a WhatsApp chat.",
                    "example": "https://wa.me/1-800-555-1212",
                    "format": "uri"
                  }
                ]
              }
            ],
            "isExpanded": true
          }
        ]
      },
      {
        "statusCode": "400",
        "description": "<p>Parameters have not been provided or are invalid e.g country_code has not been provided</p>",
        "jsonExample": "",
        "isExpanded": true
      },
      {
        "statusCode": "401",
        "description": "<p>Unauthorized, token not provided or invalid</p>",
        "jsonExample": "",
        "isExpanded": true
      },
      {
        "statusCode": "403",
        "description": "Access to the requested country or topics is not permitted for the application.",
        "jsonExample": "",
        "isExpanded": true
      }
    ],
    "examples": {
      "languages": [
        {
          "id": "7oTcXmQyQsyDm81HYzSMd",
          "language": "javascript",
          "label": "javascript",
          "code": "var myHeaders = new Headers();\nmyHeaders.append(\"accept\", \"application/json\");\nmyHeaders.append(\"content-type\", \"application/json\");\n\nvar requestOptions = {\n   method: 'GET',\n   headers: myHeaders,\n   redirect: 'follow'\n};\n\nfetch(\"https://api.throughlinecare.com/v1/helplines?country_code=string&limit=20&priority_only=boolean\", requestOptions)\n   .then(response => response.text())\n   .then(result => console.log(result))\n   .catch(error => console.log('error', error));"
        },
        {
          "id": "fN6ss0aPwo7nVKFfpgSyw",
          "language": "ruby",
          "label": "Ruby",
          "code": "require \"uri\"\nrequire \"json\"\nrequire \"net/http\"\n\nurl = URI(\"https://api.throughlinecare.com/v1/helplines?country_code=string&limit=20&priority_only=boolean\")\n\nhttps = Net::HTTP.new(url.host, url.port)\nhttps.use_ssl = true\n\nrequest = Net::HTTP::Get.new(url)\nrequest[\"accept\"] = \"application/json\"\nrequest[\"content-type\"] = \"application/json\"\n\nresponse = https.request(request)\nputs response.read_body\n"
        },
        {
          "id": "JrkyRgp6AH5r3ypxJXlH3",
          "language": "python",
          "label": "Python",
          "code": "import requests\nimport json\n\nurl = \"https://api.throughlinecare.com/v1/helplines?country_code=string&limit=20&priority_only=boolean\"\n\npayload = {}\nheaders = {\n   'accept': 'application/json',\n   'content-type': 'application/json'\n}\n\nresponse = requests.request(\"GET\", url, headers=headers, data=payload)\n\nprint(response.text)\n"
        },
        {
          "id": "HWjVfHVknj3aNCDzfzAHM",
          "language": "java",
          "label": "Java",
          "code": "OkHttpClient client = new OkHttpClient().newBuilder()\n   .build();\nMediaType mediaType = MediaType.parse(\"application/json\");\nRequestBody body = RequestBody.create(mediaType, \"\");\nRequest request = new Request.Builder()\n   .url(\"https://api.throughlinecare.com/v1/helplines?country_code=string&limit=20&priority_only=boolean\")\n   .method(\"GET\", body)\n   .addHeader(\"accept\", \"application/json\")\n   .addHeader(\"content-type\", \"application/json\")\n   .build();\nResponse response = client.newCall(request).execute();"
        },
        {
          "id": "_uWRlpItKW61S0TOxZHHB",
          "language": "swift",
          "label": "Swift",
          "code": "var request = URLRequest(url: URL(string: \"https://api.throughlinecare.com/v1/helplines?country_code=string&limit=20&priority_only=boolean\")!,timeoutInterval: Double.infinity)\nrequest.addValue(\"application/json\", forHTTPHeaderField: \"accept\")\nrequest.addValue(\"application/json\", forHTTPHeaderField: \"content-type\")\n\nrequest.httpMethod = \"GET\"\n\nlet task = URLSession.shared.dataTask(with: request) { data, response, error in \n   guard let data = data else {\n      print(String(describing: error))\n      return\n   }\n   print(String(data: data, encoding: .utf8)!)\n}\n\ntask.resume()\n"
        }
      ],
      "selectedLanguageId": "7oTcXmQyQsyDm81HYzSMd"
    },
    "results": {
      "languages": [
        {
          "id": "JvDdI8TthI1gDf3Hg3VOE",
          "language": "200",
          "code": "// Lists the available verified helplines in a given country. Helplines will be listed in an optimal order using our intelligent ranking algorithm.\n{\n  \"helplines\": [\n    {\n      \"id\": \"crisis-text-line\",\n      \"name\": \"Crisis Text Line\",\n      \"description\": \"Crisis Text Line is here to help you, whatever you're going through. We provide 24/7, free and confidential support and information by text message (text HOME to 741-741), online chat and WhatsApp (+1-443-787-7678). We are available to talk with you about any kind of experience relating to mental health, including anxiety, depression, self-harm, stress, and thoughts of suicide.\",\n      \"shortDescription\": \"24/7 free crisis support for youth in NZ\",\n      \"website\": \"https://www.crisistextline.org/\",\n      \"country\": {},\n      \"timezone\": \"America/Los_Angeles\",\n      \"topics\": [\n        \"\"\n      ],\n      \"supported_languages\": [\n        \"\"\n      ],\n      \"specialties\": [\n        \"\"\n      ],\n      \"supportTypes\": [\n        \"\"\n      ],\n      \"hours\": {},\n      \"phoneNumber\": \"1-800-555-1212\",\n      \"smsNumber\": \"741741\",\n      \"webChatUrl\": \"https://connect.crisistextline.org/chat?utm_source=findahelpline\",\n      \"whatsappUrl\": \"https://wa.me/1-800-555-1212\"\n    }\n  ]\n}"
        },
        {
          "id": "n1AOKbINXfDKEs7edRo5K",
          "language": "400",
          "code": "// Parameters have not been provided or are invalid e.g country_code has not been provided\n"
        },
        {
          "id": "KooRZj9S4TjFTHPFkh3o9",
          "language": "401",
          "code": "// Unauthorized, token not provided or invalid\n"
        },
        {
          "id": "IxugOnr6_PJKWQ4c7aEZt",
          "language": "403",
          "code": "// Access to the requested country or topics is not permitted for the application.\n"
        }
      ],
      "selectedLanguageId": "JvDdI8TthI1gDf3Hg3VOE"
    }
  },
  "children": [
    {
      "text": ""
    }
  ]
}