Withdrawal.help: detox and treatment finder

Programs listed in SAMHSA FindTreatment.gov and its opioid treatment program directory, near a ZIP code (closest first, straight-line miles) or in a state or city, for one level of care: detox, residential, outpatient, methadone clinics or buprenorphine. Each result: name, address, phone, detox setting and substances, other care settings, payment accepted, an id for get_program and its withdrawal.help page. Filters for detox substance and payment.

{
  "type": "object",
  "properties": {
    "zip": {
      "type": "string",
      "pattern": "^\\d{5}$",
      "description": "Five-digit US ZIP code, e.g. 85004. Give this, or state."
    },
    "state": {
      "type": "string",
      "pattern": "^[A-Za-z]{2}$",
      "description": "Two-letter state code, e.g. OH, when searching a state or city instead of a ZIP."
    },
    "city": {
      "type": "string",
      "minLength": 2,
      "maxLength": 60,
      "description": "City within state, e.g. \"Columbus\". Needs state."
    },
    "level": {
      "type": "string",
      "enum": [
        "detox",
        "residential",
        "outpatient",
        "methadone",
        "buprenorphine"
      ],
      "default": "detox",
      "description": "Level of care: detox (medically supervised withdrawal), residential, outpatient, methadone (federally certified opioid treatment programs) or buprenorphine (programs that prescribe it). Default detox."
    },
    "detox_for": {
      "type": "string",
      "enum": [
        "any",
        "alcohol",
        "opioids",
        "benzodiazepines"
      ],
      "default": "any",
      "description": "With level detox only: programs that list detox for this substance."
    },
    "payment": {
      "type": "string",
      "enum": [
        "any",
        "medicaid",
        "medicare",
        "private_insurance",
        "sliding_scale_or_free"
      ],
      "default": "any",
      "description": "Only programs that report accepting this payment. \"medicaid\" means some Medicaid plans; ask about a specific plan by name."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "default": 10,
      "description": "Results per page (1 to 10); page further with offset."
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "maximum": 5000,
      "default": 0,
      "description": "Results to skip, for paging."
    }
  },
  "additionalProperties": false
}

Everything withdrawal.help lists for one program, by the id find_programs returns: name, address, main, intake and hotline phones, website, levels of care, detox setting, substances and detox medications, other care settings, opioid and alcohol use disorder medications, payment and help with cost, ages, sexes, languages, special groups, licenses and accreditation as reported, with its page and a correction link.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[a-z0-9-]{3,140}$",
      "description": "Program id from find_programs: its page slug, e.g. \"1-method-los-angeles-ca\"."
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

For one US state or territory: how many SAMHSA-listed programs withdrawal.help lists at each level of care (detox, residential, outpatient, methadone clinics, buprenorphine), how many of each report taking Medicaid, Medicare, or a sliding fee scale or no charge, and the withdrawal.help list pages for the state, its filters and its largest cities.

{
  "type": "object",
  "properties": {
    "state": {
      "type": "string",
      "pattern": "^[A-Za-z]{2}$",
      "description": "Two-letter state or territory code, e.g. FL."
    }
  },
  "required": [
    "state"
  ],
  "additionalProperties": false
}