# THC Open Mindfulness Resources API

> A free, public, read-only REST API from [The Holistic Care](https://www.theholisticcare.com) exposing open mindfulness resources — research citations behind its content, a plain-language glossary of mindfulness/yoga/nonduality terms, 16 free browser-based mindfulness games, and 111 free guided-audio practices — as structured JSON. No auth or API key required.

This API is a machine-readable companion to [theholisticcare.com](https://www.theholisticcare.com), a mindfulness, yoga, and nonduality education platform for children, schools, and adults. Use it to pull verified, real research citations and canonical term definitions programmatically, rather than scraping the website.

## Endpoints

- [GET /v1/whitepapers](https://api.theholisticcare.com/v1/whitepapers) — list real, peer-reviewed research citations backing mindfulness/yoga/meditation claims. Filter by `topic` or `study_type`.
- [GET /v1/whitepapers/{slug}](https://api.theholisticcare.com/v1/whitepapers/{slug}) — a single citation with its plain-language summary, key finding, and honest limitations.
- [GET /v1/glossary](https://api.theholisticcare.com/v1/glossary) — plain-language definitions of mindfulness, yoga, nonduality, kundalini, and Ayurveda terms. Filter by `pillar`.
- [GET /v1/glossary/{slug}](https://api.theholisticcare.com/v1/glossary/{slug}) — a single term's full definition, etymology, and related terms.
- [GET /v1/mindfulness-games](https://api.theholisticcare.com/v1/mindfulness-games) — all 16 free browser-based mindfulness games for children, teens, and adults. Filter by `audience` or `skill`.
- [GET /v1/mindfulness-games/{slug}](https://api.theholisticcare.com/v1/mindfulness-games/{slug}) — a single game's metadata and direct play URL.
- [GET /v1/practices](https://api.theholisticcare.com/v1/practices) — all 111 free guided-audio practices from The Holistic Care's Stillness Library, each with a direct MP3 URL. Filter by `category`. Paid tracks are never exposed here.
- [GET /v1/practices/{slug}](https://api.theholisticcare.com/v1/practices/{slug}) — a single practice's metadata, audio URL, and related free practices.
- [GET /v1/categories](https://api.theholisticcare.com/v1/categories) — the current set of valid `topic`/`pillar` filter values.

## Documentation

- [Full docs](https://api.theholisticcare.com/docs)
- [OpenAPI 3.x spec](https://api.theholisticcare.com/openapi/openapi.yaml)
- [apis.json](https://api.theholisticcare.com/apis.json)

## Terms

Free, no attribution required, no API key. Best-effort rate limit of ~60 requests/minute per IP. Never proxies media files — only returns URLs to originals.