> 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

Learn how Unified API credits are charged on the Quick Start plan, and how add-on products are priced.

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

## At a glance

* 100,000 included Unified API credits that reset monthly.
* Tiered pricing and volume discounts as your user base grows.
* Usage Spike Protection if your usage spikes unexpectedly in your first 6 months.
* The included credits cover 500 active authentications a month, each with up to 400 events.
* Add products as you need them.

## Unified API

### How credits work

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).

### Credit prices

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                        |

### Usage Spike Protection

Rapid growth or a testing error can cause an unexpected bill. Usage Spike Protection covers this.

* 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 or implementation error, you may be eligible for a one-time refund. Specific criteria apply, such as bill threshold or usage increase.
* Contact the support team. We'll review your situation, work towards refunding the unexpected amount, and help you optimise future usage.

### What consumes credits

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>

### Model 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-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             | -                                       |
