> For the complete documentation index, see [llms.txt](https://docs.tryterra.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tryterra.co/introduction/readme.md).

# Terra documentation

Terra is 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.

## Get started

1. [Create an account and get your API keys](/introduction/account-setup-and-api-keys.md).
2. Read [Core concepts](/introduction/core-concepts.md) for the terms used throughout the docs.
3. Follow a quickstart:
   * [Unified API quickstart](/unified-api/quickstart.md): connect one user's wearable and receive their data.
   * [Order your first test](/vantage-api/ordering-your-first-test.md): place a sandbox Vantage order and receive its webhooks.

## Unified API

The [Unified API](/unified-api/getting-started.md) gives you activity, sleep, body, and nutrition data from 500+ wearables and apps, delivered to your backend as it arrives. Most apps follow these steps in order.

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Choose sources and data types</strong></td><td>Pick the providers your users can connect and the data Terra sends.</td><td><a href="/unified-api/setting-up-data-sources.md">Data sources and data types</a></td></tr><tr><td><strong>Add a destination</strong></td><td>Send data to a webhook, a database, cloud storage, or a queue.</td><td><a href="/destinations/setting-up-data-destinations.md">Overview</a></td></tr><tr><td><strong>Authenticate users</strong></td><td>Open the Terra widget from your app and store the user ID it returns.</td><td><a href="/unified-api/authentication-flow.md">User authentication</a></td></tr><tr><td><strong>Receive data events</strong></td><td>Handle new data as it arrives, and request history for new users.</td><td><a href="/unified-api/receiving-data-updates.md">Health data events</a></td></tr><tr><td><strong>Mobile SDKs</strong></td><td>Read Apple Health, Health Connect, and Samsung Health from your iOS, Android, React Native, or Flutter app.</td><td><a href="/mobile-sdks/mobile-only-sources.md">Overview</a></td></tr><tr><td><strong>Troubleshooting</strong></td><td>Find out why a user's data is missing and how to fix it.</td><td><a href="/unified-api/debugging-faq.md">Troubleshooting</a></td></tr></tbody></table>

## Vantage API

The [Vantage API](/vantage-api/overview.md) lets you order blood and DNA test kits, track fulfilment, and receive lab results in FHIR format. Most apps follow these steps in order.

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Set up access</strong></td><td>Get Vantage access, authenticate requests, and configure your webhook endpoint.</td><td><a href="/vantage-api/account-setup-and-api-keys.md">Account setup and authentication</a></td></tr><tr><td><strong>Order a test</strong></td><td>Browse the catalog and place an at-home or go-to-lab order in sandbox.</td><td><a href="/vantage-api/ordering-your-first-test.md">Ordering your first test</a></td></tr><tr><td><strong>Track orders</strong></td><td>Follow fulfilment through webhooks and fetch order status history.</td><td><a href="/vantage-api/webhooks.md">Webhooks</a></td></tr><tr><td><strong>Fetch results</strong></td><td>Download results as FHIR documents and read the Bundle structure.</td><td><a href="/vantage-api/results.md">Results</a></td></tr><tr><td><strong>Acknowledge results</strong></td><td>A mandatory step: patients cannot see results until you acknowledge them.</td><td><a href="/vantage-api/acknowledging-results.md">Acknowledging results</a></td></tr><tr><td><strong>Go to production</strong></td><td>Run the checklist before moving from sandbox to production.</td><td><a href="/vantage-api/going-to-production.md">Going to production</a></td></tr></tbody></table>

## More products

Add these alongside the Unified API or Vantage API as you need them.

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>AI Interface</strong></td><td>Read access to a user's health data for your AI agents, over MCP.</td><td><a href="/ai-interface/ai-interface.md">Overview</a></td></tr><tr><td><strong>Models</strong></td><td>Ready-to-use wellness insights computed from a user's data, returned from one endpoint.</td><td><a href="/models/models.md">Overview</a></td></tr><tr><td><strong>Graphs</strong></td><td>Charts of your users' health data, built in the Terra dashboard and embedded in your product.</td><td><a href="/graphs/graphs.md">Overview</a></td></tr><tr><td><strong>Health Scores</strong></td><td>Adaptive health and fitness scores computed from a user's connected data.</td><td><a href="/user-engagement/health-scores.md">Health Scores</a></td></tr><tr><td><strong>Planned Workouts API</strong></td><td>Structured workouts pushed to users' devices and training platforms.</td><td><a href="/planned-workouts-api/overview.md">Overview</a></td></tr><tr><td><strong>Routes API</strong></td><td>GPS routes pushed to users' Garmin, COROS, Wahoo, and Hammerhead devices.</td><td><a href="/routes-api/overview.md">Overview</a></td></tr><tr><td><strong>Streaming API</strong></td><td>Live heart rate, steps, and distance from BLE and ANT+ devices, delivered to your websocket listener.</td><td><a href="/streaming-api/getting-started.md">Overview</a></td></tr><tr><td><strong>Teams API</strong></td><td>Data aggregated across squads, matches, and individual athlete tests.</td><td><a href="/teams-api/getting-started.md">Overview</a></td></tr><tr><td><strong>Lab Reports</strong></td><td>Lab report PDFs converted into structured, standardised biomarker data.</td><td><a href="/lab-reports/lab-reports.md">Overview</a></td></tr></tbody></table>

Run a health platform and want your API available through Terra? See [Integration Partners](/integration-partners/overview.md).

## Developer tools

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Terra CLI</strong></td><td>Set up, manage, and debug your Terra setup from the terminal, for you and your AI coding agent.</td><td><a href="https://docs.tryterra.co/developer-tools/terra-cli/terra-cli">https://docs.tryterra.co/developer-tools/terra-cli/terra-cli</a></td></tr><tr><td><strong>Agent skills</strong></td><td>Terra skills for Claude Code, Cursor, Copilot, and other coding agents.</td><td><a href="https://docs.tryterra.co/developer-tools/agent-skills">https://docs.tryterra.co/developer-tools/agent-skills</a></td></tr><tr><td><strong>Example apps</strong></td><td>Complete Terra integrations you can scaffold locally with one command.</td><td><a href="https://docs.tryterra.co/developer-tools/example-apps">https://docs.tryterra.co/developer-tools/example-apps</a></td></tr></tbody></table>