Terra documentation

Terra is the Health OS for connected health data: one API for wearables, health apps, sensors, and blood tests.

Every provider has its own API, data format, and authentication. Terra integrates with hundreds of them, normalises their data into one schema, and handles authentication, so you never build or maintain an integration yourself.

Products

The Unified API is the core product. Start there, then add the others as you need them.

Unified API

Activity, sleep, body, and nutrition data from 500+ wearables and apps, including Apple Health and Samsung Health through the mobile SDKs.

Streaming API

Live heart rate, steps, and distance from BLE and ANT+ devices, delivered to your websocket listener.

AI Interface

Read access to a user's health data for your AI agents, over MCP.

Models

Ready-to-use wellness insights computed from a user's data, returned from one endpoint.

Graphs

Charts of your users' health data, built in the Terra dashboard and embedded in your product.

Health Scores

Adaptive health and fitness scores computed from a user's connected data.

Planned Workouts API

Structured workouts pushed to users' devices and training platforms.

Teams API

Data aggregated across squads, matches, and individual athlete tests.

Lab Reports

Lab report PDFs converted into structured, standardised biomarker data.

Vantage API

Order blood and DNA test kits, track fulfilment, and receive results in FHIR format.

Get started

1. Create an account and get your API keys.

2. Read Core concepts for the terms used throughout the docs.

3. Follow the Unified API quickstart to connect one user and receive their data.

Developer tools

Terra CLI

Setup, manage, and debug your Terra integration from the terminal, for you and your AI coding agent.

Agent skills

Terra skills for Claude Code, Cursor, Copilot, and other coding agents.

Example apps

Complete Terra integrations you can scaffold locally with one command.