# Ritten External API

**Canonical:** https://apis.io/apis/ritten/ritten-external-api/  
**Provider:** Ritten — https://apis.io/providers/ritten/  
**Base URL:** https://api.ritten.io/v1  
**Documentation:** https://docs.ritten.io/

Ritten External API is published by [Ritten](https://apis.io/providers/ritten/) on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Behavioral Health, EMR, EHR, Healthcare, and Patients. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, and rate-limit docs.

The Ritten External API is the public REST contract for Ritten integrating partners. It covers patients (create, read, patch, vitals, forms, relationships, attachments, external-id lookup), contacts, CRM cases in the admissions pipeline, programs, facilities, organizations, tasks, clinical encounters and encounter types, form definitions, insurance payers, users/teams and calendar events, plus a 17-operation insights family for census, admissions, discharges, average length of stay, care teams, attendance, event audit and form outcomes - most of which also export CSV via ?csv=true. Six webhook events cover patient admit/transfer/discharge/created and case created/status-update. Every request requires an OAuth 2.0 client_credentials bearer token and an X-Ritten-Tenant header identifying the clinic instance.

## Machine-readable artifacts (14)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/ritten/refs/heads/main/openapi/ritten-external-api-openapi.yaml
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/ritten/refs/heads/main/overlays/ritten-external-api-overlay.yaml
- **Documentation** — https://docs.ritten.io/
- **APIReference** — https://docs.ritten.io/
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/ritten/refs/heads/main/authentication/ritten-authentication.yml
- **Conventions** — https://raw.githubusercontent.com/api-evangelist/ritten/refs/heads/main/conventions/ritten-conventions.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/ritten/refs/heads/main/errors/ritten-problem-types.yml
- **RateLimits** — https://raw.githubusercontent.com/api-evangelist/ritten/refs/heads/main/rate-limits/ritten-rate-limits.yml
- **Webhooks** — https://raw.githubusercontent.com/api-evangelist/ritten/refs/heads/main/asyncapi/ritten-webhooks.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/ritten/refs/heads/main/data-model/ritten-data-model.yml
- **Lifecycle** — https://raw.githubusercontent.com/api-evangelist/ritten/refs/heads/main/lifecycle/ritten-lifecycle.yml
- **Sandbox** — https://raw.githubusercontent.com/api-evangelist/ritten/refs/heads/main/sandbox/ritten-sandbox.yml
- **AgentSkill** — https://raw.githubusercontent.com/api-evangelist/ritten/refs/heads/main/skills/_index.yml
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/ritten/refs/heads/main/apis.yml

## Tags

Behavioral Health, EMR, EHR, Healthcare, Patients, CRM, Reporting, Webhook, HIPAA

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/ritten/ritten-external-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/ritten/.