Substance Abuse and Mental Health Services Administration

The Substance Abuse and Mental Health Services Administration (SAMHSA) is a branch of the U.S. Department of Health and Human Services dedicated to improving the quality and availability of prevention, treatment, and recovery support services for individuals struggling with substance abuse and mental health disorders. SAMHSA provides APIs and open data for the behavioral health treatment services locator, national survey data (NSDUH), treatment episode statistics (TEDS), and state mental health data.

Substance Abuse and Mental Health Services Administration publishes 1 API on the APIs.io network: Treatment Facilities API. Tagged areas include Federal Government, Public Health, Behavioral Health, Substance Use Disorders, and Mental Health.

The Substance Abuse and Mental Health Services Administration catalog on APIs.io includes 1 JSON-LD context and 1 Spectral governance ruleset.

Substance Abuse and Mental Health Services Administration’s developer surface includes FAQ, API reference, code examples, and 18 more developer resources.

🌐 Visit website 📡 Source on GitHub

45.4/100 developing ▼ -6.1 Agent 23/100 agent aware Full breakdown ↓
scored 2026-07-28 · rubric v0.6

AccessFreemium

3 APIs

Federal GovernmentPublic HealthBehavioral HealthSubstance Use DisordersMental HealthOpen DataHealthcare

Kin Score

Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6

Composite quality — 45.4/100 · developing

Contract Quality 16.3 / 25

Developer Ergonomics 1.3 / 20

Commercial Clarity 12.1 / 20

Operational Transparency 4.8 / 13

Governance 8.3 / 12

Discoverability 6.5 / 10

Agent readiness — 23/100 · agent aware

Machine-Readable Contract 18 / 18

Agentic Access Contract 10 / 10

MCP Server 0 / 12

Machine-Readable Auth 0 / 10

Idempotency 0 / 9

Stable Error Semantics 0 / 8

Request/Response Examples 7 / 7

Rate-Limit Signaling 7 / 7

Typed Event Surface 0 / 6

Agent Skills 0 / 5

Well-Known Catalog 0 / 4

Consent & Bot Identity 0 / 3

A2A Agent Card 0 / 8

Dry-Run / Simulate Mode 0 / 4

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/substance-abuse-and-mental-health-services-administration: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 3

Individual APIs this provider publishes, each with its own machine-readable definition.

Rate Limits 1

Documented rate limits and quota policies.

Substance Abuse And Mental Health Services Administration Rate Limits

5 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

JSON Schema 2

Standalone JSON Schema definitions for this provider's data models.

Examples 1

Example request and response payloads for these APIs.

AGENTIC

Resources

Get Started 1

Portal, sign-up, and the first successful call

Data Portal

Data Portal

Documentation 3

Reference material describing how the API behaves

APIReference

APIReference

JSONSchema

JSONSchema

JSONSchema

JSONSchema

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess

AgenticAccess

Design & Contract 3

Pagination, idempotency, versioning, errors, and events

Vocabulary

Vocabulary

JSONLDContext

JSONLDContext

JSONStructure

JSONStructure

Build 2

SDKs, sample code, and the tooling you integrate with

GitHubOrganization

GitHubOrganization

Examples

Examples

Access & Security 1

Authentication, authorization, and security posture

DomainSecurity

DomainSecurity

Operate 2

Status, limits, changes, and where to get help

National Helpline

National Helpline

FAQ

FAQ

Commercial 2

Pricing, plans, and the legal terms of use

TermsOfService

TermsOfService

PrivacyPolicy

PrivacyPolicy

Company 2

The organization behind the API

LinkedIn

Website

Website

Other 4

Properties that don't map to a standard resource type

Treatment Locator

Treatment Locator

Data Files

Data Files

988 Suicide & Crisis Lifeline

988 Suicide & Crisis Lifeline

Data.gov Catalog

Data.gov Catalog

Source (apis.yml)

aid: substance-abuse-and-mental-health-services-administration
url: https://raw.githubusercontent.com/api-evangelist/substance-abuse-and-mental-health-services-administration/refs/heads/main/apis.yml
apis:
- aid: substance-abuse-and-mental-health-services-administration:samhsa-data-portal
  name: SAMHSA Data Portal
  tags:
  - Open Data
  - Survey Data
  - NSDUH
  - Statistics
  - Public Health
  humanURL: https://www.datafiles.samhsa.gov
  properties:
  - url: https://www.datafiles.samhsa.gov
    type: Documentation
  - url: https://www.samhsa.gov/data/
    type: Data Portal
  - url: https://pdas.samhsa.gov/sapt
    type: State Data
  description: SAMHSA's data portal provides access to national and state-level behavioral health statistics including the
    National Survey on Drug Use and Health (NSDUH), Treatment Episode Data Set (TEDS), and National Survey of Substance Abuse
    Treatment Services (N-SSATS). Data available for download in SAS, SPSS, and Stata formats.
- aid: substance-abuse-and-mental-health-services-administration:samhsa-mental-health-atlas
  name: SAMHSA Mental Health Client Level Data
  tags:
  - Mental Health
  - Client Data
  - Statistics
  - Open Data
  humanURL: https://www.samhsa.gov/data/report/2020-mental-health-client-level-data-cld
  properties:
  - url: https://www.samhsa.gov/data/report/2020-mental-health-client-level-data-cld
    type: Documentation
  description: Client-Level Data (CLD) from state mental health agencies on clients receiving state-funded mental health services.
    Provides data on demographics, diagnoses, services received, and outcomes.
- aid: substance-abuse-and-mental-health-services-administration:substance-abuse-and-mental-health-services-administration-treatment-facilities-api
  name: Substance Abuse and Mental Health Services Administration Treatment Facilities API
  description: Search and retrieve behavioral health treatment facility listings
  humanURL: https://findtreatment.gov
  tags:
  - Treatment Facilities
  properties:
  - type: OpenAPI
    url: openapi/substance-abuse-and-mental-health-services-administration-treatment-facilities-api-openapi.yml
  - type: Documentation
    url: https://findtreatment.gov
  - type: National Helpline
    url: https://www.samhsa.gov/find-help/national-helpline
name: Substance Abuse and Mental Health Services Administration
tags:
- Federal Government
- Public Health
- Behavioral Health
- Substance Use Disorders
- Mental Health
- Open Data
- Healthcare
kind: contract
accessModel:
  pricing: freemium
  onboarding: unknown
  trial: false
  try_now: false
  public: false
  label: Freemium
  confidence: medium
  source:
  - plans
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/substance-abuse-and-mental-health-services-administration.png
access: 3rd-Party
created: '2024-12-03'
modified: '2026-05-19'
position: Consuming
description: The Substance Abuse and Mental Health Services Administration (SAMHSA) is a branch of the U.S. Department of
  Health and Human Services dedicated to improving the quality and availability of prevention, treatment, and recovery support
  services for individuals struggling with substance abuse and mental health disorders. SAMHSA provides APIs and open data
  for the behavioral health treatment services locator, national survey data (NSDUH), treatment episode statistics (TEDS),
  and state mental health data.
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
specificationVersion: '0.19'
common:
- type: AgenticAccess
  url: agentic-access/substance-abuse-and-mental-health-services-administration-agentic-access.yml
- type: DomainSecurity
  url: security/substance-abuse-and-mental-health-services-administration-domain-security.yml
- type: LinkedIn
  url: https://www.linkedin.com/company/substance-abuse-and-mental-health-services-administration
- url: https://www.samhsa.gov
  type: Website
- url: https://findtreatment.gov
  type: Treatment Locator
- url: https://www.samhsa.gov/data/
  type: Data Portal
- url: https://www.datafiles.samhsa.gov
  type: Data Files
- url: https://www.samhsa.gov/find-help/national-helpline
  type: National Helpline
- url: https://988lifeline.org
  type: 988 Suicide & Crisis Lifeline
- url: https://www.samhsa.gov/about-us/who-we-are/faq
  type: FAQ
- url: https://www.samhsa.gov/data/terms-use
  type: TermsOfService
- url: https://www.samhsa.gov/privacy
  type: PrivacyPolicy
- url: https://github.com/samhsa
  type: GitHubOrganization
- url: https://catalog.data.gov/dataset?organization=samhsa-hhs
  type: Data.gov Catalog
- url: https://api.data.gov/docs/samhsa/
  type: APIReference
- url: vocabulary/samhsa-vocabulary.yml
  type: Vocabulary
- url: json-ld/samhsa-context.jsonld
  type: JSONLDContext
- url: json-schema/samhsa-treatment-facility-schema.json
  type: JSONSchema
- url: json-schema/samhsa-nsduh-data-schema.json
  type: JSONSchema
- url: json-structure/samhsa-treatment-facility-structure.json
  type: JSONStructure
- url: examples/samhsa-search-treatment-facilities-example.json
  type: Examples