Ritten API

Does Ritten have a public API?

Ritten, the behavioral health EMR for detox, residential, PHP, IOP and outpatient programs, publishes no developer API or documentation; its site says integration options are confirmed with each program during evaluation. Integuru generates a production-ready HTTP API from your Ritten login, with 18 verified actions across the census, individual and group encounters, forms, documents and authorizations.

An evaluation-time conversation works for a treatment center choosing its EMR. A documentation vendor whose customer already runs Ritten needs the encounter and the group note reachable this month. Integuru covers that with direct HTTP requests to the endpoints the Ritten web app uses, authenticated, using your own credentials, with login and any second factor handled for you.

What you can do with the Ritten API

A residential program's day runs from a morning process group through an intake to an afternoon utilization review call, and that last call needs signed notes and the current authorization for every client under review. The actions cover each of those.

Census and chart

• list_patients returns the roster filtered by program_statuses (default active; former is the discharged bucket), admit_start_date and admit_end_date, and search_text on name or MRN, 20 per page in createdAt_desc order to match the roster UI.
• get_patient and get_patient_v2 read one patient UUID; get_patient_authorizations returns the payer authorizations on file for that patient.

Individual and group encounters

• create_encounter opens an encounter for a patient_id with an encounter_type matched exactly to the account's individual types; date defaults to today.
• create_group_encounter builds a session from a title, an encounter_template_id (from list_group_encounter_templates) and a participants array with optional per-client notes, plus date, start_time, end_time and PDF documents. send_forms_to_charts: true submits the session to every participant's chart; the default leaves it in Draft.
• list_encounters_by_date returns every encounter between date_from and date_to in clinic-local time, optionally filtered by exact encounter_type. list_patient_encounters pages one patient's history; list_patient_encounters_detailed adds date bounds in a timezone and, with include_signature_detail, who signed and cosigned each form.
• delete_encounter and delete_document_and_empty_encounter remove only what the acting user created and only when the encounter is empty.

Forms and documents

• list_patient_forms filters a patient's forms by search_query on title; get_form_submission returns a completed form's answers and export_form_pdf renders it, both by form_instance_id.
• list_patient_documents, get_document (as a dataurl or metadata only) and upload_patient_document cover the chart's attachments. Uploads take file_name, file_base64, an exact document_type (default Correspondence), an optional title, and an encounter_id to file the document under a session rather than loosely on the chart.

Who uses this

AI scribe and group-note tools write the morning process group through create_group_encounter, one note per participant, and file the session with send_forms_to_charts. Utilization review teams pull list_patient_encounters_detailed with signature detail and get_patient_authorizations before a payer call, so the case is argued from signed notes and the current auth. Outcomes and analytics teams read get_form_submission for every completed assessment to track scores across a stay. Programs that run a second EMR at another level of care pair this page with the Sunwave and Lightning Step integrations, and billing teams add the Insync page for claims work. The healthcare industry page covers behavioral health alongside the rest of the clinical stack.

Setup notes

Integuru authenticates against login.ritten.io with your Ritten user. Every identifier on this platform is a UUID: patients, encounters, documents and form instances. Encounter and document types are matched by exact display name, and a mismatch returns the valid names rather than creating anything. Date ranges are clinic-local calendar days; list_patient_encounters_detailed lets you set the IANA timezone, which defaults to America/Los_Angeles. upload_patient_document accepts document_date for compatibility but Ritten records the server upload time.

Get started

Install the CLI and connect your Ritten login:

npm install -g integuru

Or sign in at app.integuru.com, add Ritten, and call list_patients for the active census. Scheduling, medication orders, claims and the bed board are built on request through the Managed Service.