SAMHSA Behavioral Health Treatment Services Locator API — Treatment Facilities

naftiko: 1.0.0-alpha2
info:
  label: SAMHSA Behavioral Health Treatment Services Locator API — Treatment Facilities
  description: 'SAMHSA Behavioral Health Treatment Services Locator API — Treatment Facilities. 1 operations. Lead operation:
    Search Treatment Facilities. Self-contained Naftiko capability covering one Substance Abuse And Mental Health Services
    Administration business surface.'
  tags:
  - Substance Abuse And Mental Health Services Administration
  - Treatment Facilities
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    SUBSTANCE_ABUSE_AND_MENTAL_HEALTH_SERVICES_ADMINISTRATION_API_KEY: SUBSTANCE_ABUSE_AND_MENTAL_HEALTH_SERVICES_ADMINISTRATION_API_KEY
capability:
  consumes:
  - type: http
    namespace: samhsa-treatment-locator-treatment-facilities
    baseUri: https://findtreatment.gov/locator/listing
    description: SAMHSA Behavioral Health Treatment Services Locator API — Treatment Facilities business capability. Self-contained,
      no shared references.
    resources:
    - name: listing
      path: /listing
      operations:
      - name: searchtreatmentfacilities
        method: GET
        description: Search Treatment Facilities
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: sAddr
          in: query
          type: string
          description: Street address to search near
        - name: sCity
          in: query
          type: string
          description: City to search in
        - name: sState
          in: query
          type: string
          description: Two-letter state abbreviation (e.g., CA, TX)
        - name: sZip
          in: query
          type: string
          description: ZIP code to search near
        - name: sDistance
          in: query
          type: integer
          description: Search radius in miles
        - name: sCatCode
          in: query
          type: string
          description: 'Category code: SA (substance abuse), MH (mental health), CO (co-occurring)'
        - name: sType
          in: query
          type: string
          description: Facility type code
        - name: sService
          in: query
          type: string
          description: Service type code (e.g., detox, residential, outpatient)
        - name: sMedicaid
          in: query
          type: string
          description: Filter for Medicaid-accepting facilities
        - name: sMedicare
          in: query
          type: string
          description: Filter for Medicare-accepting facilities
        - name: sSlidingFee
          in: query
          type: string
          description: Filter for sliding-scale fee facilities
        - name: sNoFee
          in: query
          type: string
          description: Filter for no-cost treatment facilities
        - name: page
          in: query
          type: integer
          description: Page number for paginated results
        - name: pageSize
          in: query
          type: integer
          description: Number of results per page
  exposes:
  - type: rest
    namespace: samhsa-treatment-locator-treatment-facilities-rest
    port: 8080
    description: REST adapter for SAMHSA Behavioral Health Treatment Services Locator API — Treatment Facilities. One Spectral-compliant
      resource per consumed operation, prefixed with /v1.
    resources:
    - path: /v1/listing
      name: listing
      description: REST surface for listing.
      operations:
      - method: GET
        name: searchtreatmentfacilities
        description: Search Treatment Facilities
        call: samhsa-treatment-locator-treatment-facilities.searchtreatmentfacilities
        with:
          sAddr: rest.sAddr
          sCity: rest.sCity
          sState: rest.sState
          sZip: rest.sZip
          sDistance: rest.sDistance
          sCatCode: rest.sCatCode
          sType: rest.sType
          sService: rest.sService
          sMedicaid: rest.sMedicaid
          sMedicare: rest.sMedicare
          sSlidingFee: rest.sSlidingFee
          sNoFee: rest.sNoFee
          page: rest.page
          pageSize: rest.pageSize
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: samhsa-treatment-locator-treatment-facilities-mcp
    port: 9090
    transport: http
    description: MCP adapter for SAMHSA Behavioral Health Treatment Services Locator API — Treatment Facilities. One tool
      per consumed operation, routed inline through this capability's consumes block.
    tools:
    - name: search-treatment-facilities
      description: Search Treatment Facilities
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: samhsa-treatment-locator-treatment-facilities.searchtreatmentfacilities
      with:
        sAddr: tools.sAddr
        sCity: tools.sCity
        sState: tools.sState
        sZip: tools.sZip
        sDistance: tools.sDistance
        sCatCode: tools.sCatCode
        sType: tools.sType
        sService: tools.sService
        sMedicaid: tools.sMedicaid
        sMedicare: tools.sMedicare
        sSlidingFee: tools.sSlidingFee
        sNoFee: tools.sNoFee
        page: tools.page
        pageSize: tools.pageSize
      outputParameters:
      - type: object
        mapping: $.