Terra

Terra is a unified wearables and health-data API that aggregates data from 500+ wearables, fitness trackers, and health apps - Garmin, Fitbit, Oura, Apple Health, Whoop, Strava, Google Fit, Polar, Withings, and many more - behind a single normalized REST interface. Developers connect end users through the Terra Widget or a custom authentication flow, then receive normalized Activity, Body, Daily, Sleep, Nutrition, Menstruation, and Athlete data. Terra's primary delivery model is asynchronous - requested and newly available health data is streamed to a developer-configured webhook destination rather than returned inline, with REST read endpoints available for on-demand historical pulls.

Terra publishes 10 APIs on the APIs.io network, including Activity API, Athlete API, Authentication API, and 7 more. Tagged areas include Wearables, Health Data, Fitness, Aggregator, and Webhooks.

Terra’s developer surface includes authentication, documentation, engineering blog, and 8 more developer resources.

36.5/100 thin ▬ flat Agent 34/100 agent aware Full breakdown ↓
scored 2026-08-05 · rubric v0.9.1
AccessPaidSelf serve
11 APIs
WearablesHealth DataFitnessAggregatorWebhooksDigital Health

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-08-05 · rubric v0.9.1
Composite quality — 36.5/100 · thin
Contract Quality 15.9 / 25
Developer Ergonomics 4.3 / 20
Commercial Clarity 7.9 / 20
Operational Transparency 4.8 / 13
Governance 0.0 / 12
Discoverability 7.4 / 10
Agent readiness — 34/100 · agent aware
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 8
Request/Response Examples 7 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/terra-api: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 11

Individual APIs this provider publishes, each with its own machine-readable definition.

Terra Webhooks

Terra's primary data-delivery mechanism. Rather than a polling or WebSocket transport, Terra streams normalized health data and lifecycle events - auth, deauth, connection error...

Terra Activity API

Workout and exercise sessions.

Terra Athlete API

Connected-user athlete profile and demographics.

Terra Authentication API

Connect and disconnect end-user wearable and health accounts.

Terra Body API

Body and biometric measurements.

Terra Daily API

Day-level aggregated summaries.

Terra Integrations API

Catalog of supported wearables, trackers, and health apps.

Terra Menstruation API

Menstrual cycle and reproductive health data.

Terra Nutrition API

Logged nutrition and dietary intake.

Terra Sleep API

Sleep sessions and stages.

Terra Users API

Look up and manage connected users and subscriptions.

Scroll for all 11

Open Collections 1

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

Terra API

OPEN COLLECTION

Pricing Plans 1

Published pricing tiers and plan structures.

Rate Limits 1

Documented rate limits and quota policies.

Terra Api Rate Limits

3 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Terra Api Authentication

apiKey · 2 schemes

SECURITY

Terra Api Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Terra Api Agentic Access

16 operations · 5 acting

16 operations · 5 acting

AGENTIC

Resources

Documentation 1

Reference material describing how the API behaves

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

Build 1

SDKs, sample code, and the tooling you integrate with

Access & Security 2

Authentication, authorization, and security posture

Operate 1

Status, limits, changes, and where to get help

Commercial 2

Pricing, plans, and the legal terms of use

Company 3

The organization behind the API

Source (apis.yml)

apis.yml Raw ↑
aid: terra-api
url: https://raw.githubusercontent.com/api-evangelist/terra-api/refs/heads/main/apis.yml
name: Terra
kind: company
description: Terra is a unified wearables and health-data API that aggregates data from 500+ wearables, fitness trackers,
  and health apps - Garmin, Fitbit, Oura, Apple Health, Whoop, Strava, Google Fit, Polar, Withings, and many more - behind
  a single normalized REST interface. Developers connect end users through the Terra Widget or a custom authentication flow,
  then receive normalized Activity, Body, Daily, Sleep, Nutrition, Menstruation, and Athlete data. Terra's primary delivery
  model is asynchronous - requested and newly available health data is streamed to a developer-configured webhook destination
  rather than returned inline, with REST read endpoints available for on-demand historical pulls.
accessModel:
  pricing: paid
  onboarding: self-serve
  trial: false
  try_now: false
  public: false
  label: Paid · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/terra-api.png
tags:
- Wearables
- Health Data
- Fitness
- Aggregator
- Webhooks
- Digital Health
created: '2026-07-03'
modified: '2026-07-03'
specificationVersion: '0.19'
apis:
- aid: terra-api:terra-api-webhooks
  name: Terra Webhooks
  tags:
  - Webhooks
  - Data Streaming
  - Events
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://docs.tryterra.co/health-and-fitness-api/integration-setup/setting-up-data-destinations/webhooks
  baseURL: https://api.tryterra.co/v2
  properties:
  - url: https://docs.tryterra.co/health-and-fitness-api/integration-setup/setting-up-data-destinations/webhooks
    type: Documentation
  - url: https://docs.tryterra.co/reference/health-and-fitness-api/event-types
    type: APIReference
  description: Terra's primary data-delivery mechanism. Rather than a polling or WebSocket transport, Terra streams normalized
    health data and lifecycle events - auth, deauth, connection errors, and activity/body/daily/sleep/nutrition/ menstruation
    payloads - by HTTP POST to a developer-configured webhook endpoint, signed for verification. Historical data requests
    with to_webhook=true are fulfilled asynchronously to this same destination.
- aid: terra-api:terra-api-activity-api
  name: Terra Activity API
  description: Workout and exercise sessions.
  humanURL: https://docs.tryterra.co/health-and-fitness-api/user-authentication
  baseURL: https://api.tryterra.co/v2
  tags:
  - Activity
  properties:
  - type: OpenAPI
    url: openapi/terra-api-activity-api-openapi.yml
  - type: Documentation
    url: https://docs.tryterra.co/health-and-fitness-api/user-authentication
  - type: APIReference
    url: https://docs.tryterra.co/reference/health-and-fitness-api/readme
  - type: Documentation
    url: https://docs.tryterra.co/reference/health-and-fitness-api/data-models
  - type: Documentation
    url: https://docs.tryterra.co/reference/health-and-fitness-api/supported-integrations
- aid: terra-api:terra-api-athlete-api
  name: Terra Athlete API
  description: Connected-user athlete profile and demographics.
  humanURL: https://docs.tryterra.co/health-and-fitness-api/user-authentication
  baseURL: https://api.tryterra.co/v2
  tags:
  - Athlete
  properties:
  - type: OpenAPI
    url: openapi/terra-api-athlete-api-openapi.yml
  - type: Documentation
    url: https://docs.tryterra.co/health-and-fitness-api/user-authentication
  - type: APIReference
    url: https://docs.tryterra.co/reference/health-and-fitness-api/readme
  - type: Documentation
    url: https://docs.tryterra.co/reference/health-and-fitness-api/data-models
  - type: Documentation
    url: https://docs.tryterra.co/reference/health-and-fitness-api/supported-integrations
- aid: terra-api:terra-api-authentication-api
  name: Terra Authentication API
  description: Connect and disconnect end-user wearable and health accounts.
  humanURL: https://docs.tryterra.co/health-and-fitness-api/user-authentication
  baseURL: https://api.tryterra.co/v2
  tags:
  - Authentication
  properties:
  - type: OpenAPI
    url: openapi/terra-api-authentication-api-openapi.yml
  - type: Documentation
    url: https://docs.tryterra.co/health-and-fitness-api/user-authentication
  - type: APIReference
    url: https://docs.tryterra.co/reference/health-and-fitness-api/readme
  - type: Documentation
    url: https://docs.tryterra.co/reference/health-and-fitness-api/data-models
  - type: Documentation
    url: https://docs.tryterra.co/reference/health-and-fitness-api/supported-integrations
- aid: terra-api:terra-api-body-api
  name: Terra Body API
  description: Body and biometric measurements.
  humanURL: https://docs.tryterra.co/health-and-fitness-api/user-authentication
  baseURL: https://api.tryterra.co/v2
  tags:
  - Body
  properties:
  - type: OpenAPI
    url: openapi/terra-api-body-api-openapi.yml
  - type: Documentation
    url: https://docs.tryterra.co/health-and-fitness-api/user-authentication
  - type: APIReference
    url: https://docs.tryterra.co/reference/health-and-fitness-api/readme
  - type: Documentation
    url: https://docs.tryterra.co/reference/health-and-fitness-api/data-models
  - type: Documentation
    url: https://docs.tryterra.co/reference/health-and-fitness-api/supported-integrations
- aid: terra-api:terra-api-daily-api
  name: Terra Daily API
  description: Day-level aggregated summaries.
  humanURL: https://docs.tryterra.co/health-and-fitness-api/user-authentication
  baseURL: https://api.tryterra.co/v2
  tags:
  - Daily
  properties:
  - type: OpenAPI
    url: openapi/terra-api-daily-api-openapi.yml
  - type: Documentation
    url: https://docs.tryterra.co/health-and-fitness-api/user-authentication
  - type: APIReference
    url: https://docs.tryterra.co/reference/health-and-fitness-api/readme
  - type: Documentation
    url: https://docs.tryterra.co/reference/health-and-fitness-api/data-models
  - type: Documentation
    url: https://docs.tryterra.co/reference/health-and-fitness-api/supported-integrations
- aid: terra-api:terra-api-integrations-api
  name: Terra Integrations API
  description: Catalog of supported wearables, trackers, and health apps.
  humanURL: https://docs.tryterra.co/health-and-fitness-api/user-authentication
  baseURL: https://api.tryterra.co/v2
  tags:
  - Integrations
  properties:
  - type: OpenAPI
    url: openapi/terra-api-integrations-api-openapi.yml
  - type: Documentation
    url: https://docs.tryterra.co/health-and-fitness-api/user-authentication
  - type: APIReference
    url: https://docs.tryterra.co/reference/health-and-fitness-api/readme
  - type: Documentation
    url: https://docs.tryterra.co/reference/health-and-fitness-api/data-models
  - type: Documentation
    url: https://docs.tryterra.co/reference/health-and-fitness-api/supported-integrations
- aid: terra-api:terra-api-menstruation-api
  name: Terra Menstruation API
  description: Menstrual cycle and reproductive health data.
  humanURL: https://docs.tryterra.co/health-and-fitness-api/user-authentication
  baseURL: https://api.tryterra.co/v2
  tags:
  - Menstruation
  properties:
  - type: OpenAPI
    url: openapi/terra-api-menstruation-api-openapi.yml
  - type: Documentation
    url: https://docs.tryterra.co/health-and-fitness-api/user-authentication
  - type: APIReference
    url: https://docs.tryterra.co/reference/health-and-fitness-api/readme
  - type: Documentation
    url: https://docs.tryterra.co/reference/health-and-fitness-api/data-models
  - type: Documentation
    url: https://docs.tryterra.co/reference/health-and-fitness-api/supported-integrations
- aid: terra-api:terra-api-nutrition-api
  name: Terra Nutrition API
  description: Logged nutrition and dietary intake.
  humanURL: https://docs.tryterra.co/health-and-fitness-api/user-authentication
  baseURL: https://api.tryterra.co/v2
  tags:
  - Nutrition
  properties:
  - type: OpenAPI
    url: openapi/terra-api-nutrition-api-openapi.yml
  - type: Documentation
    url: https://docs.tryterra.co/health-and-fitness-api/user-authentication
  - type: APIReference
    url: https://docs.tryterra.co/reference/health-and-fitness-api/readme
  - type: Documentation
    url: https://docs.tryterra.co/reference/health-and-fitness-api/data-models
  - type: Documentation
    url: https://docs.tryterra.co/reference/health-and-fitness-api/supported-integrations
- aid: terra-api:terra-api-sleep-api
  name: Terra Sleep API
  description: Sleep sessions and stages.
  humanURL: https://docs.tryterra.co/health-and-fitness-api/user-authentication
  baseURL: https://api.tryterra.co/v2
  tags:
  - Sleep
  properties:
  - type: OpenAPI
    url: openapi/terra-api-sleep-api-openapi.yml
  - type: Documentation
    url: https://docs.tryterra.co/health-and-fitness-api/user-authentication
  - type: APIReference
    url: https://docs.tryterra.co/reference/health-and-fitness-api/readme
  - type: Documentation
    url: https://docs.tryterra.co/reference/health-and-fitness-api/data-models
  - type: Documentation
    url: https://docs.tryterra.co/reference/health-and-fitness-api/supported-integrations
- aid: terra-api:terra-api-users-api
  name: Terra Users API
  description: Look up and manage connected users and subscriptions.
  humanURL: https://docs.tryterra.co/health-and-fitness-api/user-authentication
  baseURL: https://api.tryterra.co/v2
  tags:
  - Users
  properties:
  - type: OpenAPI
    url: openapi/terra-api-users-api-openapi.yml
  - type: Documentation
    url: https://docs.tryterra.co/health-and-fitness-api/user-authentication
  - type: APIReference
    url: https://docs.tryterra.co/reference/health-and-fitness-api/readme
  - type: Documentation
    url: https://docs.tryterra.co/reference/health-and-fitness-api/data-models
  - type: Documentation
    url: https://docs.tryterra.co/reference/health-and-fitness-api/supported-integrations
common:
- type: AgenticAccess
  url: agentic-access/terra-api-agentic-access.yml
- type: DomainSecurity
  url: security/terra-api-domain-security.yml
- type: Authentication
  url: authentication/terra-api-authentication.yml
- type: GitHubOrganization
  url: https://github.com/tryterra
- type: LinkedIn
  url: https://www.linkedin.com/company/terraapi
- type: Website
  url: https://tryterra.co
- type: Documentation
  url: https://docs.tryterra.co
- type: Plans
  url: plans/terra-api-plans-pricing.yml
- type: RateLimits
  url: rate-limits/terra-api-rate-limits.yml
- type: FinOps
  url: finops/terra-api-finops.yml
- type: Blog
  url: https://www.tryterra.co/blog
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com