> 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/unified-api/pricing.md).

# Pricing

How Terra pricing works: the Quick Start plan, Unified API credits, and the add-on products you can activate alongside it.

Terra pricing starts with the Unified API on the Quick Start plan, which uses transparent, usage-based pricing powered by Unified API credits. Add-on products extend the plan, and each is priced on its own. This page explains how both work.

{% hint style="success" %}

### At a glance

✅ 100,000 included Unified API credits that reset monthly\
🪜 Tiered pricing + discounts that rewards user growth\
💸 If your project blows-up over night, we’ll have your back\
🧘 You're likely never paying extra until you're ready to scale, see details below\
🧩 Add products as you need them
{% endhint %}

* [How do Unified API credits work?](#understanding-unified-api-credits)
* [How much does a Unified API credit cost?](#terras-pricing-scales-with-your-business)
* [How are Unified API credits consumed?](#how-unified-api-credits-are-consumed)
* [Add-on products](#add-on-products)

***

## Unified API

### Understanding Unified API credits

1. **Monthly allowance:** Your Quick Start subscription gives you 100,000 free Unified API credits each month.
2. **Usage:** Unified API usage consumes Unified API credits, based on connected users and events.
3. **Monthly reset:** Unified API credits reset to 100,000 each billing period and do not roll over.
4. **Scaling:** Only pay for Unified API credits beyond your 100,000 monthly allowance. Additional usage is billed monthly.
5. **Volume Discount:** The more Unified API credits you use, the cheaper each one gets (tiered pricing).

### Terra’s pricing scales with your business

Your Quick Start subscription includes 100,000 monthly Unified API credits - covering the needs of most startups during their initial launch and growth phases. Tiered pricing applies beyond this:

| **Total Monthly Unified API Credits Consumed** | **Cost per Additional Credit** |
| ---------------------------------------------- | ------------------------------ |
| 0 - 100,000                                    | $0 (Included in subscription)  |
| 100,001 - 1,000,000                            | $0.005                         |
| 1,000,001+                                     | $0.003                         |

{% hint style="success" %}

### Unexpected usage spike led to a surprise bill?

**Usage Spike Protection has your back.**

* We understand that rapid growth (especially for startups) or testing errors can cause unforeseen costs. That's why our **Usage Spike Protection** is here to ensure you're not penalised.
* If you receive an **unexpectedly large bill** in your **initial 6 months** (counted from the first invoice charged to your card) due to a significant spike from rapid user growth or a testing/integration error, you may be eligible for a **one-time refund**. (Specific criteria apply, such as bill threshold or usage increase).
* Simply reach out to our support team. We'll review your situation, work towards refunding the unexpected amount, and help you optimise future usage.
* **We believe in growing** with our developers **for the long term**, and that means supporting you when things take off faster than planned, or when something simply goes wrong.
  {% endhint %}

### How Unified API credits are consumed

The number of Unified API credits consumed monthly scales with your number of users (active authentications) and events.

<table><thead><tr><th>About</th><th valign="top">Active authentications</th><th>Events</th></tr></thead><tbody><tr><td><strong>What it is</strong></td><td valign="top">An active authentication represents an end-user's wearable, sensor, or fitness app that has been authenticated with Terra</td><td><p>Data payloads and notifications sent by Terra to your backend. This includes:</p><ul><li><em>Data Sync Events:</em> Health, activity, sleep, workout data, etc.</li><li><em>Authentication Events:</em> User authentication status or permission updates.</li></ul></td></tr><tr><td><strong>How it's measured</strong></td><td valign="top"><p>An active authentication represents a health data source that both:</p><ol><li>Has been authenticated by an end user</li><li>Has not been deauthenticated</li></ol></td><td><p>Each individual event transmission is counted.</p><ul><li>Example: A webhook sending a Daily payload for one end-user is one event</li><li><p>Free tier: 400 events per active authentication</p><ul><li><em>95% of customers are never charged for events</em></li></ul></li></ul></td></tr><tr><td><strong>Cost</strong></td><td valign="top">200 Unified API credits per active authentication per month</td><td><p>The first 400 events per active authentication are free.</p><p>0.5 Unified API credits per event beyond this.</p></td></tr></tbody></table>

### Models credits

<table><thead><tr><th>About</th><th valign="top">Model run</th></tr></thead><tbody><tr><td><strong>What it is</strong></td><td valign="top">A model run applies one of Terra's health models (e.g. Sleep Window, Health Terrain) to a single user's data for a date range, returning a ready-to-use insight.</td></tr><tr><td><strong>How it's measured</strong></td><td valign="top">Each run counts as one, regardless of how much data the date range covers. Running two models — or the same model on two users — is two runs.</td></tr><tr><td><strong>Cost</strong></td><td valign="top">1 credit per model run ($0.01 per credit).</td></tr></tbody></table>

***

## Add-on products

Add-on products extend your plan. Activate them from **Settings → Plans & Pricing → Additional Products** on the dashboard. Each add-on is billed separately from your plan fee.

Add-ons that use credits have their own credit balance. Add-on usage never draws down your Unified API credits, and Unified API usage never draws down an add-on's credits. Each add-on's pricing page explains what consumes its credits.

| **Add-on**                                                               | **Price**              | **Includes**                            |
| ------------------------------------------------------------------------ | ---------------------- | --------------------------------------- |
| [Lab Reports API](/lab-reports/pricing.md)                               | $499/month + usage     | 100,000 Lab Reports credits a month     |
| [Planned Workouts](/planned-workouts-api/pricing.md)                     | $99/month + usage      | 20,000 Planned Workouts credits a month |
| [Streaming API](/streaming-api/pricing.md)                               | $99/month + usage      | 20,000 Streaming credits a month        |
| [Health Scores](/user-engagement/health-scores/health-scores-pricing.md) | $499/month             | 14-day free trial                       |
| [Graph API](/graphs/pricing.md)                                          | $50/month per 2 graphs | -                                       |
| [Health Rewards](https://tryterra.co/products/health-rewards)            | Contact us             | -                                       |
