# Pricing

Terra’s Health & Fitness API uses transparent, usage-based pricing powered by credits. This page explains how it works.

{% hint style="success" %}

## At a glance

✅ 100,000 included 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
{% endhint %}

* [How do credits work?](#how-do-credits-work)
* [How much does a credit cost?](#terras-pricing-scales-with-your-business)
* [How are credits consumed?](#how-credits-are-consumed)

***

## Understanding credits

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

***

### Terra’s pricing scales with your business

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

| **Total Monthly 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** 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 credits are consumed

Credits are consumed by usage of Terra's Health & Fitness API. The number of credits consumed monthly scales with your number of users (active authentications) and events.

### Unified Health API credits

<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 credits per active authentication per month</td><td><p>The first 400 events per active authentication are free.</p><p></p><p>0.5 credits per event beyond this.</p></td></tr></tbody></table>

### Blood Report API credits

<table><thead><tr><th>About</th><th valign="top">Biomarker</th></tr></thead><tbody><tr><td><strong>What it is</strong></td><td valign="top">A biomarker represents a single standardized clinical measurement extracted, normalized, and structured from a lab report (e.g. LDL-C, HbA1c, CRP). Biomarkers may originate from different labs but are returned in a consistent, machine-readable format.</td></tr><tr><td><strong>How it's measured</strong></td><td valign="top">Each biomarker parsed counts toward usage. Multiple biomarkers can be extracted from a single lab report.</td></tr><tr><td><strong>Cost</strong></td><td valign="top"><p>The first 3500 biomarkers are included.</p><p></p><p>30 credits per biomarker beyond this.</p></td></tr></tbody></table>