Terra Docs
Dashboard
  • Docs
  • API Reference
  • Changelog
  • Getting Started
    • What is Terra API?
    • Account setup and API keys
    • Core concepts
  • Health & Fitness API
    • Overview
    • Quickstart
    • Integration setup
      • Understanding sources and destinations
      • Setting up data sources
      • Setting up data destinations
        • Webhooks
        • SQL database (Postgres, MySQL)
        • Supabase
        • Cloud storage (S3, GCP)
        • Queuing services (SQS, Kafka)
      • Customising data types
      • Dedicated data source API keys
      • Understanding Terra environments
    • User authentication
      • Authentication flow
      • Implementation (Terra widget)
      • Implementation (Custom UI)
      • Handling authentication events
      • Customising authentication redirects
    • Managing user health data
      • Receiving health data updates (events)
      • Requesting historical health data (REST API requests)
      • Writing data
    • Mobile-only sources
      • iOS (Swift)
      • Android (Kotlin)
      • React Native
      • Flutter
    • Troubleshooting
    • Pricing
  • User Engagement
    • Health Scores
  • Streaming API
    • Overview
    • Wearable -> Your app
      • iOS (Swift)
      • Android
    • Your app -> Terra
      • iOS (Swift)
      • Android
    • Terra -> Your backend
  • Teams API
  • Biomarkers API - Upcoming
Powered by GitBook
On this page
  • Understanding credits
  • Terra’s pricing scales with your business
  • How credits are consumed

Was this helpful?

  1. Health & Fitness API

Pricing

This page outlines pricing for the Health & Fitness API on the Quick Start plan.

PreviousTroubleshootingNextHealth Scores

Last updated 8 days ago

Was this helpful?

Terra’s Health & Fitness 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

  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

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 Health & Fitness API. The number of credits consumed monthly scales with your number of users (active authentications) and events.

About
Active authentications
Events

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:

  1. Has been authenticated by an end user

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

How do credits work?
How much does a credit cost?
How are credits consumed?