# 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>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>30 credits per biomarker beyond this.</p></td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

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

```
GET https://docs.tryterra.co/health-and-fitness-api/pricing.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.