Cadasto Developer Documentation

Welcome to the Cadasto developer docs. Cadasto is a healthcare data platform built on openEHR, providing a standards-based API for storing, querying, and managing clinical data.

These docs cover authentication, API usage, the openEHR data model, and query language — everything you need to start integrating with Cadasto.

Quick Start

Authenticate and make your first API request in minutes.

Authentication

Set up OAuth 2.0 Client Credentials and obtain an access token.

openEHR Concepts

Understand the data model behind the APIs: archetypes, templates, and compositions.

AQL Query Language

Write queries to retrieve clinical data from EHR records.

API References

EHR API

Create and manage EHRs, versioned compositions, directories, and contributions with full audit trails. View API

Query API

Execute ad-hoc and stored AQL queries across EHRs using archetype paths. View API

Definition API

Upload and manage operational templates (OPT) and stored queries. View API

Demographic API

Manage persons, organisations, roles, and party relationships — separated from clinical data by design. View API

Admin API

Privileged operations for system administration and EHR management. View API

System API

Discover server capabilities, supported services, and conformance details. View API

Extra API

Cadasto-specific convenience endpoints: datamaps, episodes of care, terminology helpers, and user info. View API

SMART on openEHR

SMART App Launch for openEHR — service discovery, authorization, and third-party app integration. View API

Getting Started

Before calling any API, you need an access token. See the Authentication guide to set up OAuth 2.0 Client Credentials.

New to openEHR? Read the openEHR Concepts guide first, then follow the Quick Start to create an EHR, upload a template, and commit your first composition.

Introduction