# Terra Docs

## Docs

- [What is Terra API?](https://docs.tryterra.co/introduction/readme.md)
- [Account setup and API keys](https://docs.tryterra.co/introduction/account-setup-and-api-keys.md): This guide walks you through creating your Terra account and obtaining the API keys necessary to start integrating with our services.
- [Core concepts](https://docs.tryterra.co/introduction/core-concepts.md): Understand the fundamental terms and concepts used throughout the Terra API ecosystem. Grasping these will help you integrate Terra more effectively.
- [Overview](https://docs.tryterra.co/health-and-fitness-api/getting-started.md): Discover the capabilities of Terra's Health & Fitness API, enabling you to access historical and current user health data from a multitude of health data sources.
- [Quickstart](https://docs.tryterra.co/health-and-fitness-api/quickstart.md): Learn how to receive data events in just 3 steps
- [Integration setup](https://docs.tryterra.co/health-and-fitness-api/integration-setup.md): Configure Terra API to receive your users' health & fitness data to your preferred destination (e.g. webhook, DB, etc).
- [Understanding sources and destinations](https://docs.tryterra.co/health-and-fitness-api/integration-setup/understanding-sources-and-destinations.md)
- [Setting up data sources](https://docs.tryterra.co/health-and-fitness-api/integration-setup/setting-up-data-sources.md)
- [Setting up data destinations](https://docs.tryterra.co/health-and-fitness-api/integration-setup/setting-up-data-destinations.md)
- [Webhooks](https://docs.tryterra.co/health-and-fitness-api/integration-setup/setting-up-data-destinations/webhooks.md)
- [SQL database (Postgres, MySQL)](https://docs.tryterra.co/health-and-fitness-api/integration-setup/setting-up-data-destinations/sql-database-postgres-mysql.md)
- [Supabase](https://docs.tryterra.co/health-and-fitness-api/integration-setup/setting-up-data-destinations/supabase.md)
- [Cloud storage (S3, GCS, Azure Blob)](https://docs.tryterra.co/health-and-fitness-api/integration-setup/setting-up-data-destinations/cloud-storage-s3-gcp.md)
- [Queuing services (SQS, Kafka)](https://docs.tryterra.co/health-and-fitness-api/integration-setup/setting-up-data-destinations/queuing-services-sqs-kafka.md)
- [MongoDB](https://docs.tryterra.co/health-and-fitness-api/integration-setup/setting-up-data-destinations/mongodb.md)
- [Firestore](https://docs.tryterra.co/health-and-fitness-api/integration-setup/setting-up-data-destinations/firestore.md)
- [Customising data types](https://docs.tryterra.co/health-and-fitness-api/integration-setup/customising-data-types.md): Customise the types of data events you wish to receive from your users (activity, sleep, etc).
- [Dedicated data source API keys](https://docs.tryterra.co/health-and-fitness-api/integration-setup/dedicated-data-source-api-keys.md)
- [Understanding Terra environments](https://docs.tryterra.co/health-and-fitness-api/integration-setup/understanding-terra-environments.md)
- [User authentication](https://docs.tryterra.co/health-and-fitness-api/user-authentication.md): Securely connect your users' health data sources to your application via Terra.
- [Authentication flow](https://docs.tryterra.co/health-and-fitness-api/user-authentication/authentication-flow.md)
- [Implementation (Terra widget)](https://docs.tryterra.co/health-and-fitness-api/user-authentication/implementation-terra-widget.md)
- [Implementation (Custom UI)](https://docs.tryterra.co/health-and-fitness-api/user-authentication/implementation-custom-ui.md)
- [Handling authentication events](https://docs.tryterra.co/health-and-fitness-api/user-authentication/handling-authentication-events.md)
- [Customising authentication redirects](https://docs.tryterra.co/health-and-fitness-api/user-authentication/customising-authentication-redirects.md)
- [Managing user health data](https://docs.tryterra.co/health-and-fitness-api/managing-user-health-data.md): Access user health and fitness information from Terra and, where supported, write data back to connected services.
- [Receiving health data updates (events)](https://docs.tryterra.co/health-and-fitness-api/managing-user-health-data/receiving-data-updates.md): Learn how to receive data update events to your app as soon as the user's data syncs to the cloud
- [Requesting historical health data (REST API requests)](https://docs.tryterra.co/health-and-fitness-api/managing-user-health-data/requesting-historical-data.md): Learn how to request for historical data to be sent to your destination through the REST API
- [Writing data](https://docs.tryterra.co/health-and-fitness-api/managing-user-health-data/write-data.md): Learn how to write data back to providers, and create a bi-directional data stream between your app and the various integrations you connect to
- [Mobile-only sources](https://docs.tryterra.co/health-and-fitness-api/mobile-only-sources.md): Learn how to connect mobile-based integrations: Apple Health, Samsung Health, Google Fit
- [iOS (Swift)](https://docs.tryterra.co/health-and-fitness-api/mobile-only-sources/ios-swift.md): The iOS SDK allows you to seamlessly send data from iOS to your backend or to your app directly!
- [Android (Kotlin)](https://docs.tryterra.co/health-and-fitness-api/mobile-only-sources/android-kotlin.md): How to use the TerraAndroid SDK to connect mobile-based integrations?
- [React Native](https://docs.tryterra.co/health-and-fitness-api/mobile-only-sources/react-native.md)
- [Flutter](https://docs.tryterra.co/health-and-fitness-api/mobile-only-sources/flutter.md)
- [Troubleshooting](https://docs.tryterra.co/health-and-fitness-api/debugging-faq.md)
- [Pricing](https://docs.tryterra.co/health-and-fitness-api/pricing.md): This page outlines pricing for the Health & Fitness API on the Quick Start plan.
- [WHOOP](https://docs.tryterra.co/health-and-fitness-api/whoop.md)
- [Dexcom](https://docs.tryterra.co/health-and-fitness-api/dexcom.md)
- [Health Scores](https://docs.tryterra.co/user-engagement/health-scores.md): Learn how to embed adaptive health scores in your app
- [Health Rewards](https://docs.tryterra.co/health-rewards.md)
- [Overview](https://docs.tryterra.co/streaming-api/getting-started.md)
- [Wearable -> Your app](https://docs.tryterra.co/streaming-api/connect-wearable-to-sdk.md)
- [iOS (Swift)](https://docs.tryterra.co/streaming-api/connect-wearable-to-sdk/ios-swift.md)
- [Android](https://docs.tryterra.co/streaming-api/connect-wearable-to-sdk/android.md)
- [React Native](https://docs.tryterra.co/streaming-api/connect-wearable-to-sdk/react-native.md)
- [Flutter](https://docs.tryterra.co/streaming-api/connect-wearable-to-sdk/flutter.md)
- [WearOS connection](https://docs.tryterra.co/streaming-api/connect-wearable-to-sdk/wear-os.md)
- [Your app -> Terra](https://docs.tryterra.co/streaming-api/your-app-greater-than-terra.md)
- [iOS (Swift)](https://docs.tryterra.co/streaming-api/your-app-greater-than-terra/ios-swift.md)
- [Android](https://docs.tryterra.co/streaming-api/your-app-greater-than-terra/android.md)
- [React Native](https://docs.tryterra.co/streaming-api/your-app-greater-than-terra/react-native.md)
- [Flutter](https://docs.tryterra.co/streaming-api/your-app-greater-than-terra/flutter.md)
- [Terra -> Your backend](https://docs.tryterra.co/streaming-api/terra-greater-than-your-backend.md): Set up and manage a consumer connection to the Terra WebSocket service to receive real-time health data.
- [Getting Started](https://docs.tryterra.co/teams-api/getting-started.md)

## API Reference

- [REST API Endpoints](https://docs.tryterra.co/reference/health-and-fitness-api/readme.md)
- [OpenAPI Spec](https://docs.tryterra.co/reference/health-and-fitness-api/openapi-spec.md): Outlines where to access Terra's OpenAPI Spec
- [Supported integrations](https://docs.tryterra.co/reference/health-and-fitness-api/supported-integrations.md): Outlines the currently supported integrations & any surrounding info around them
- [Event Types](https://docs.tryterra.co/reference/health-and-fitness-api/event-types.md)
- [Data models](https://docs.tryterra.co/reference/health-and-fitness-api/data-models.md)
- [Samples](https://docs.tryterra.co/reference/health-and-fitness-api/samples.md)
- [Core concepts](https://docs.tryterra.co/reference/health-and-fitness-api/core-concepts.md)
- [Destinations](https://docs.tryterra.co/reference/health-and-fitness-api/destinations.md)
- [Mobile SDK](https://docs.tryterra.co/reference/health-and-fitness-api/sdk-references.md)
- [iOS (Swift)](https://docs.tryterra.co/reference/health-and-fitness-api/sdk-references/ios-swift.md)
- [Android (Kotlin)](https://docs.tryterra.co/reference/health-and-fitness-api/sdk-references/android-kotlin.md)
- [React Native](https://docs.tryterra.co/reference/health-and-fitness-api/sdk-references/react-native.md)
- [Flutter](https://docs.tryterra.co/reference/health-and-fitness-api/sdk-references/flutter.md)
- [REST API Endpoints](https://docs.tryterra.co/reference/streaming-api/api-endpoints.md)
- [Supported Integrations](https://docs.tryterra.co/reference/streaming-api/supported-integrations.md)
- [Core Concepts](https://docs.tryterra.co/reference/streaming-api/core-concepts.md)
- [Websocket Reference](https://docs.tryterra.co/reference/streaming-api/websocket-reference.md)
- [Mobile SDK](https://docs.tryterra.co/reference/streaming-api/reference.md)
- [iOS (Swift)](https://docs.tryterra.co/reference/streaming-api/reference/ios-swift.md)
- [Android (Kotlin)](https://docs.tryterra.co/reference/streaming-api/reference/android-kotlin.md)
- [Flutter](https://docs.tryterra.co/reference/streaming-api/reference/flutter.md)
- [React Native](https://docs.tryterra.co/reference/streaming-api/reference/react-native.md)
- [Supported Integrations](https://docs.tryterra.co/reference/teams-api/supported-integrations.md)
- [Core Concepts](https://docs.tryterra.co/reference/teams-api/core-concepts.md)
- [API Endpoints](https://docs.tryterra.co/reference/teams-api/api-endpoints.md)
- [Event types](https://docs.tryterra.co/reference/teams-api/event-types.md)

## Changelog

- [April Update 2026](https://docs.tryterra.co/changelog/2026/april-update-2026.md): Check out what we've been doing at Terra over the month of April 2026!
- [March Update 2026](https://docs.tryterra.co/changelog/2026/march-update-2026.md)
- [February Update 2026](https://docs.tryterra.co/changelog/2026/february-update-2026.md)
- [January Update 2026](https://docs.tryterra.co/changelog/2026/january-update-2026.md)
- [December Update 2025](https://docs.tryterra.co/changelog/2025/december-update-2025.md)
- [November Update 2025](https://docs.tryterra.co/changelog/2025/november-update-2025.md)
- [October Update 2025](https://docs.tryterra.co/changelog/2025/october-update-2025.md)
- [September Update 2025](https://docs.tryterra.co/changelog/2025/september-update-2025.md)
- [August Update 2025](https://docs.tryterra.co/changelog/2025/august-update-2025.md)
- [July Update 2025](https://docs.tryterra.co/changelog/2025/readme.md)
- [June Update 2025](https://docs.tryterra.co/changelog/2025/readme-1.md)
- [May Update 2025](https://docs.tryterra.co/changelog/2025/readme-2.md)
- [April Update 2025](https://docs.tryterra.co/changelog/2025/readme-1-1.md)
- [March Update 2025](https://docs.tryterra.co/changelog/2025/readme-2-1.md)
- [February Update 2025](https://docs.tryterra.co/changelog/2025/february-update-2025.md)
- [January Update 2025](https://docs.tryterra.co/changelog/2025/readme-1-1-1.md)
- [December Update 2024](https://docs.tryterra.co/changelog/2024/2024-december-update.md)
- [November Updates 2024](https://docs.tryterra.co/changelog/2024/2024-november-updates.md)
- [October Updates 2024](https://docs.tryterra.co/changelog/2024/2024-october-updates.md)
- [September Updates 2024](https://docs.tryterra.co/changelog/2024/2024-september-updates.md)
- [August Updates 2024](https://docs.tryterra.co/changelog/2024/2024-august-updates.md)
- [July Updates 2024](https://docs.tryterra.co/changelog/2024/2024-july-updates.md)
- [June Updates 2024](https://docs.tryterra.co/changelog/2024/2024-june-updates.md)
- [May Updates 2024](https://docs.tryterra.co/changelog/2024/2024-may-updates.md)
- [April Updates 2024](https://docs.tryterra.co/changelog/2024/2024-april-updates.md)
- [March 2024](https://docs.tryterra.co/changelog/2024/2024-march.md)
- [February Updates 2024](https://docs.tryterra.co/changelog/2024/2024-february-updates.md)
- [January Updates 2024](https://docs.tryterra.co/changelog/2024/2024-january-updates.md)
- [December Updates 2023](https://docs.tryterra.co/changelog/2023/2024-december-updates.md)
- [November Updates 2023](https://docs.tryterra.co/changelog/2023/2023-november-updates.md)
- [October Updates 2023](https://docs.tryterra.co/changelog/2023/2023-october-updates.md)
- [September Updates 2023](https://docs.tryterra.co/changelog/2023/2023-september-updates.md)
- [August Updates 2023](https://docs.tryterra.co/changelog/2023/2023-august-updates.md)
- [July Updates 2023](https://docs.tryterra.co/changelog/2023/2023-july-updates.md)
- [June Updates 2023](https://docs.tryterra.co/changelog/2023/2023-june-updates.md)
- [June 27, 2023](https://docs.tryterra.co/changelog/2023/2023-06-27.md)
- [June 16, 2023](https://docs.tryterra.co/changelog/2023/2023-06-16.md)
- [June 5, 2023](https://docs.tryterra.co/changelog/2023/2023-06-05.md)
- [May Updates 2023](https://docs.tryterra.co/changelog/2023/2023-may-updates.md)
- [May 19, 2023](https://docs.tryterra.co/changelog/2023/2023-05-19.md)
- [April Updates 2023](https://docs.tryterra.co/changelog/2023/2023-april-updates.md)
- [April 27, 2023](https://docs.tryterra.co/changelog/2023/2023-04-27.md)
- [April 18, 2023](https://docs.tryterra.co/changelog/2023/2023-04-18.md)
- [April 11, 2023](https://docs.tryterra.co/changelog/2023/2023-04-11.md)
- [March Updates 2023](https://docs.tryterra.co/changelog/2023/2023-march-updates.md)
- [March 29, 2023](https://docs.tryterra.co/changelog/2023/2023-03-29.md)
- [March 22, 2023](https://docs.tryterra.co/changelog/2023/2023-03-22.md)
- [March 13, 2023](https://docs.tryterra.co/changelog/2023/2023-03-13.md)
- [March 6, 2023](https://docs.tryterra.co/changelog/2023/2023-03-06.md)
- [February Updates 2023](https://docs.tryterra.co/changelog/2023/2023-february-updates.md)
- [February 21, 2023](https://docs.tryterra.co/changelog/2023/2023-02-21.md)
- [February 7, 2023](https://docs.tryterra.co/changelog/2023/2023-02-07.md)
- [January Updates 2023](https://docs.tryterra.co/changelog/2023/2023-january-updates.md)
- [January 30, 2023](https://docs.tryterra.co/changelog/2023/2023-01-30.md)
- [December 15, 2022](https://docs.tryterra.co/changelog/2022/2022-12-15.md)
- [December 7, 2022](https://docs.tryterra.co/changelog/2022/2022-12-07.md)
- [November 22, 2022](https://docs.tryterra.co/changelog/2022/2022-11-22.md)
- [December Updates 1](https://docs.tryterra.co/changelog/general-updates/december-updates-1.md)
- [December Updates](https://docs.tryterra.co/changelog/general-updates/december-updates.md)
- [November Updates](https://docs.tryterra.co/changelog/general-updates/november-updates.md)
- [October Updates](https://docs.tryterra.co/changelog/general-updates/october-updates.md)
- [September Updates](https://docs.tryterra.co/changelog/general-updates/september-updates.md)
- [August Updates](https://docs.tryterra.co/changelog/general-updates/august-updates.md)
- [July Updates](https://docs.tryterra.co/changelog/general-updates/july-updates.md)
- [June Updates](https://docs.tryterra.co/changelog/general-updates/june-updates.md)
- [May Updates](https://docs.tryterra.co/changelog/general-updates/may-updates.md)
- [April Updates](https://docs.tryterra.co/changelog/general-updates/april-updates.md)
- [March Updates](https://docs.tryterra.co/changelog/general-updates/march-updates.md)
- [February Updates](https://docs.tryterra.co/changelog/general-updates/february-updates.md)
- [January Updates](https://docs.tryterra.co/changelog/general-updates/january-updates.md)
- [Page 1](https://docs.tryterra.co/changelog/general-updates/page-1.md)

## AI

- [Terra AI](https://docs.tryterra.co/ai-interface/terra-ai.md)
- [Error states](https://docs.tryterra.co/ai-interface/error-states.md)

## Vantage API Docs

- [What is Vantage API?](https://docs.tryterra.co/vantage-api-docs/readme.md)
- [Account setup and API keys](https://docs.tryterra.co/vantage-api-docs/account-setup-and-api-keys.md): This guide walks you through obtaining the API keys necessary to start using our services. Currently, account set up for new partners is done manually but we will change this in the future!
- [Ordering your first test](https://docs.tryterra.co/vantage-api-docs/getting-started/ordering-your-first-test.md): Learn how to order a test kit in a few simple steps
- [Working with Sandbox](https://docs.tryterra.co/vantage-api-docs/getting-started/publish-your-docs.md)
- [Webhooks](https://docs.tryterra.co/vantage-api-docs/documentation/webhooks.md)
- [Test Collection Methods](https://docs.tryterra.co/vantage-api-docs/documentation/test-collection-methods.md)
- [Results](https://docs.tryterra.co/vantage-api-docs/documentation/results.md)
- [Acknowledging Results](https://docs.tryterra.co/vantage-api-docs/important-information/acknowledging-results.md): This guide outlines the critical process of acknowledging patient results within the system. Result acknowledgment is a mandatory step that ensures proper communication of test outcomes, regardless of

## Vantage API Reference

- [Activation](https://docs.tryterra.co/vantage-api-reference/core-resources/activation.md)
- [Clients](https://docs.tryterra.co/vantage-api-reference/core-resources/clients.md)
- [Orders](https://docs.tryterra.co/vantage-api-reference/core-resources/orders.md)
- [Products](https://docs.tryterra.co/vantage-api-reference/core-resources/products.md)
- [Results](https://docs.tryterra.co/vantage-api-reference/core-resources/results.md)

## Integration Partners

- [Overview](https://docs.tryterra.co/integration-partners/overview.md)
- [How the integration works](https://docs.tryterra.co/integration-partners/how-the-integration-works.md)
- [Submitting an Application](https://docs.tryterra.co/integration-partners/submitting-an-application.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on a page URL with the `ask` query parameter:

```
GET https://docs.tryterra.co/introduction/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.