The Resources API from The Holistic Care — THC Open Mindfulness API — 1 operation(s) for resources.
1 of 1 operations are conformant: apis.io called them with no credentials and the responses matched this contract. Checked 2026-11-12. how this works · status file
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/theholisticcare:theholisticcare-resources-api"curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Theholisticcare Resources API
version: 1.0.0
contact:
name: The Holistic Care
url: https://www.theholisticcare.com
email: info@theholisticcare.com
license:
name: MIT (code only — see LICENSING.md for content rights)
url: https://github.com/mohanagc/thc-open-mindfulness-api/blob/main/LICENSE
description: 'Operations tagged Resources across 2 of this provider''s published API definitions: theholisticcare-openapi.yaml, theholisticcare-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.theholisticcare.com
description: Production (only environment currently deployed)
tags:
- name: Resources
paths:
/v1/resources:
get:
summary: Browse every public resource family at once
description: A discovery/browse layer over 6 families (blog, mindfulness games, guided practices, research citations, glossary terms, PanchaVikas). Not a replacement for the dedicated per-family endpoints — call those directly for the full field set of a specific family.
parameters:
- $ref: '#/components/parameters/limit'
- $ref: '#/components/parameters/offset'
- name: type
in: query
schema:
type: string
enum:
- blog
- mindfulness_game
- guided_practice
- research
- glossary
- panchavikas_pathway
- panchavikas_download
- name: category
in: query
schema:
type: string
- name: audience
in: query
schema:
type: string
- name: skill
in: query
schema:
type: string
- name: age_min
in: query
schema:
type: integer
- name: age_max
in: query
schema:
type: integer
responses:
'200':
description: A paginated list of normalized public resources.
content:
application/json:
schema:
$ref: '#/components/schemas/ResourceListResponse'
'400':
description: 'Invalid `type` value (`invalid_type`), or a malformed `limit`/ `offset` value (`invalid_parameter`) — see /docs#pagination.
'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
$ref: '#/components/responses/RateLimited'
tags:
- Resources
operationId: getV1Resources
x-operation-id-source: derived
servers:
- url: https://api.theholisticcare.com
description: Production (only environment currently deployed)
components:
parameters:
limit:
name: limit
in: query
description: 'Max records to return (default 20). A non-numeric, non-integer, or non-positive value (e.g. `abc`, `1.5`, `0`, `-1`) returns a 400 `invalid_parameter` error rather than silently falling back to the default. A value above the documented maximum (100) is the one exception: it is NOT an error, it is silently clamped to 100 — see /docs#pagination for the full rationale for that one intentional exception.
'
schema:
type: integer
default: 20
maximum: 100
offset:
name: offset
in: query
description: 'Records to skip (default 0). A non-numeric, non-integer, or negative value (e.g. `abc`, `1.5`, `-1`) returns a 400 `invalid_parameter` error rather than silently falling back to 0 — see /docs#pagination.
'
schema:
type: integer
default: 0
schemas:
Error:
type: object
properties:
error:
type: object
properties:
code:
type: string
description: Short, machine-readable identifier. See /docs#errors for the full list.
example: not_found
message:
type: string
description: Human-readable, safe to show a developer. Never a stack trace or internal detail.
example:
error:
code: not_found
message: No public blog post found for slug "example-slug".
Meta:
type: object
description: Present on every successful response.
properties:
generated_at:
type: string
format: date-time
provider:
type: string
example: The Holistic Care
source:
type: string
example: https://www.theholisticcare.com
Resource:
type: object
description: 'The common normalized shape used by /v1/resources and /v1/search across all 6 families. Fields not applicable to a given resource''s type are null rather than fabricated. `id` is populated for every resource, using each family''s existing stable public identifier where one already exists (mindfulness_game uses its `MG-*` api_id, guided_practice uses its `SL-*` track_id, panchavikas_* uses its `PV-*` id), or a deterministic `type:slug` pair otherwise (e.g. `blog:<slug>`, `research:<slug>`, `glossary:<slug>`) — never a raw Sanity `_id`. `slug` is populated for every type except panchavikas_pathway/panchavikas_download, which have no real slug field and are always null there. A blog-type resource still always has `category` set to null (unlike id/slug, which changed 2026-09-25 — see HANDOFF.md), matching the fact that blog posts have no equivalent taxonomy field exposed elsewhere in this API. Note this Resource shape (used only by /v1/resources and /v1/search) is intentionally richer than the dedicated /v1/blog endpoint''s own response, which still omits id/slug/type/updated_at entirely per Mohan''s original instruction for that endpoint specifically.
'
properties:
id:
type: string
title:
type: string
slug:
type:
- string
- 'null'
type:
type: string
enum:
- blog
- mindfulness_game
- guided_practice
- research
- glossary
- panchavikas_pathway
- panchavikas_download
summary:
type:
- string
- 'null'
category:
type:
- string
- 'null'
tags:
type:
- array
- 'null'
items:
type: string
audiences:
type:
- array
- 'null'
items:
type: string
age_min:
type:
- integer
- 'null'
age_max:
type:
- integer
- 'null'
duration_minutes:
type:
- integer
- 'null'
skills:
type:
- array
- 'null'
items:
type: string
access:
type:
- string
- 'null'
description: e.g. "free". Never "paid" — no paid content is ever exposed by this API.
source_url:
type: string
updated_at:
type:
- string
- 'null'
format: date-time
example:
id: MG-001
title: Breathing Buddy
slug: breathing-buddy
type: mindfulness_game
summary: A gentle breathing pacer for young children.
category: Breathing
tags:
- breathing
- calm
- kids
audiences:
- children
age_min: 5
age_max: 12
duration_minutes: 5
skills:
- breathwork
access: free
source_url: https://www.theholisticcare.com/games/breathing-buddy.html
updated_at: '2026-09-24T00:00:00.000Z'
ResourceListResponse:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Resource'
pagination:
$ref: '#/components/schemas/Pagination'
meta:
$ref: '#/components/schemas/Meta'
Pagination:
type: object
properties:
limit:
type: integer
offset:
type: integer
total:
type: integer
Resource_2:
type: object
description: 'The common normalized shape used by /v1/resources and /v1/search across all 7 families. Fields not applicable to a given resource''s type are null rather than fabricated. `id` is populated for every resource, using each family''s existing stable public identifier where one already exists (mindfulness_game uses its `MG-*` api_id, guided_practice uses its `SL-*` track_id, podcast_episode uses its `PC-S01E01-EN` id, panchavikas_* uses its `PV-*` id), or a deterministic `type:slug` pair otherwise (e.g. `blog:<slug>`, `research:<slug>`, `glossary:<slug>`) — never a raw Sanity `_id`. `slug` is populated for every type except panchavikas_pathway/panchavikas_download, which have no real slug field and are always null there. A blog-type resource still always has `category` set to null (unlike id/slug, which changed 2026-09-25 — see HANDOFF.md), matching the fact that blog posts have no equivalent taxonomy field exposed elsewhere in this API. Note this Resource shape (used only by /v1/resources and /v1/search) is intentionally richer than the dedicated /v1/blog endpoint''s own response, which still omits id/slug/type/updated_at entirely per Mohan''s original instruction for that endpoint specifically.
'
properties:
id:
type: string
title:
type: string
slug:
type:
- string
- 'null'
type:
type: string
enum:
- blog
- mindfulness_game
- guided_practice
- research
- glossary
- podcast_episode
- panchavikas_pathway
- panchavikas_download
summary:
type:
- string
- 'null'
category:
type:
- string
- 'null'
tags:
type:
- array
- 'null'
items:
type: string
audiences:
type:
- array
- 'null'
items:
type: string
age_min:
type:
- integer
- 'null'
age_max:
type:
- integer
- 'null'
duration_minutes:
type:
- integer
- 'null'
skills:
type:
- array
- 'null'
items:
type: string
access:
type:
- string
- 'null'
description: e.g. "free". Never "paid" — no paid content is ever exposed by this API.
source_url:
type: string
updated_at:
type:
- string
- 'null'
format: date-time
example:
id: MG-001
title: Breathing Buddy
slug: breathing-buddy
type: mindfulness_game
summary: A gentle breathing pacer for young children.
category: Breathing
tags:
- breathing
- calm
- kids
audiences:
- children
age_min: 5
age_max: 12
duration_minutes: 5
skills:
- breathwork
access: free
source_url: https://www.theholisticcare.com/games/breathing-buddy.html
updated_at: '2026-09-24T00:00:00.000Z'
responses:
RateLimited:
description: 'Too many requests from this IP recently (best-effort ~60 req/min; see /docs#rate-limiting for the honest limitations of this enforcement on serverless infrastructure).
'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
x-refined-from:
- theholisticcare-openapi.yaml
- theholisticcare-openapi.yml
x-provenance:
method: harvested
publisher: The Holistic Care — THC Open Mindfulness API
source: https://api.theholisticcare.com/openapi/openapi.yaml
note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
stamped by stamp-openapi-provenance.py (roadmap#793)