Pricing
This page outlines pricing for the Unified API on the Quick Start plan.
Terra’s Unified API uses transparent, usage-based pricing powered by credits. This page explains how it works.
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
Understanding credits
Monthly allowance: Your subscription gives you 100,000 free credits each month.
Usage: Unified API usage consumes credits, based on connected users and events.
Monthly reset: Credits reset to 100,000 each billing period and do not roll over.x
Scaling: Only pay for credits beyond your 100,000 monthly allowance. Additional usage is billed monthly.
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
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.
How credits are consumed
Credits are consumed by usage of Terra's Unified API. The number of credits consumed monthly scales with your number of users (active authentications) and events.
Unified API credits
What it is
An active authentication represents an end-user's wearable, sensor, or fitness app that has been authenticated with Terra
Data payloads and notifications sent by Terra to your backend. This includes:
Data Sync Events: Health, activity, sleep, workout data, etc.
Authentication Events: User authentication status or permission updates.
How it's measured
An active authentication represents a health data source that both:
Has been authenticated by an end user
Has not been deauthenticated
Each individual event transmission is counted.
Example: A webhook sending a Daily payload for one end-user is one event
Free tier: 400 events per active authentication
95% of customers are never charged for events
Cost
200 credits per active authentication per month
The first 400 events per active authentication are free.
0.5 credits per event beyond this.
Blood Report API credits
What it is
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.
How it's measured
Each biomarker parsed counts toward usage. Multiple biomarkers can be extracted from a single lab report.
Cost
The first 3500 biomarkers are included.
30 credits per biomarker beyond this.
Models credits
What it is
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.
How it's measured
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.
Cost
1 credit per model run ($0.01 per credit).
Last updated
Was this helpful?