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.
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
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-authentication-api
  name: Terra Authentication API
  tags:
  - Authentication
  - Widget
  - User Onboarding
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://docs.tryterra.co/health-and-fitness-api/user-authentication
  baseURL: https://api.tryterra.co/v2
  properties:
  - url: https://docs.tryterra.co/health-and-fitness-api/user-authentication
    type: Documentation
  - url: https://docs.tryterra.co/reference/health-and-fitness-api/readme
    type: APIReference
  - url: openapi/terra-api-openapi.yml
    type: OpenAPI
  description: Connect end users to their wearable and health accounts. Generate a
    Terra Widget session or a custom authentication link, mint auth tokens for the
    Terra mobile SDKs, and deauthenticate users to revoke data access. This is the
    onboarding front door to every downstream Terra data type.
- aid: terra-api:terra-api-user-management-api
  name: Terra User Management API
  tags:
  - Users
  - Subscriptions
  - Management
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://docs.tryterra.co/reference/health-and-fitness-api/readme
  baseURL: https://api.tryterra.co/v2
  properties:
  - url: https://docs.tryterra.co/reference/health-and-fitness-api/readme
    type: APIReference
  - url: openapi/terra-api-openapi.yml
    type: OpenAPI
  description: Look up connected users and their metadata. Retrieve a single user by
    Terra user ID or your reference ID, list all connected user IDs (subscriptions)
    with pagination, and batch-query multiple users at once via bulk user info.
- aid: terra-api:terra-api-activity-api
  name: Terra Activity API
  tags:
  - Activity
  - Workouts
  - Exercise
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://docs.tryterra.co/reference/health-and-fitness-api/data-models
  baseURL: https://api.tryterra.co/v2
  properties:
  - url: https://docs.tryterra.co/reference/health-and-fitness-api/data-models
    type: Documentation
  - url: openapi/terra-api-openapi.yml
    type: OpenAPI
  description: Retrieve normalized workout and exercise sessions for a user over a
    date range - GPS routes, heart-rate zones, distance, calories, power, cadence,
    and per-activity samples. Results are streamed to your webhook when to_webhook is
    true, or returned inline for smaller pulls.
- aid: terra-api:terra-api-body-api
  name: Terra Body API
  tags:
  - Body
  - Biometrics
  - Heart Rate
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://docs.tryterra.co/reference/health-and-fitness-api/data-models
  baseURL: https://api.tryterra.co/v2
  properties:
  - url: https://docs.tryterra.co/reference/health-and-fitness-api/data-models
    type: Documentation
  - url: openapi/terra-api-openapi.yml
    type: OpenAPI
  description: Retrieve body and biometric measurements for a user - weight, body
    composition, blood pressure, blood glucose, SpO2, hydration, temperature, and
    continuous heart-rate samples - normalized across every supported device.
- aid: terra-api:terra-api-daily-api
  name: Terra Daily API
  tags:
  - Daily
  - Steps
  - Summaries
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://docs.tryterra.co/reference/health-and-fitness-api/data-models
  baseURL: https://api.tryterra.co/v2
  properties:
  - url: https://docs.tryterra.co/reference/health-and-fitness-api/data-models
    type: Documentation
  - url: openapi/terra-api-openapi.yml
    type: OpenAPI
  description: Retrieve day-level aggregated summaries for a user - steps, distance,
    active and total calories, active durations, heart-rate summaries, and stress -
    rolled up per calendar day across supported wearables.
- aid: terra-api:terra-api-sleep-api
  name: Terra Sleep API
  tags:
  - Sleep
  - Sleep Stages
  - Recovery
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://docs.tryterra.co/reference/health-and-fitness-api/data-models
  baseURL: https://api.tryterra.co/v2
  properties:
  - url: https://docs.tryterra.co/reference/health-and-fitness-api/data-models
    type: Documentation
  - url: openapi/terra-api-openapi.yml
    type: OpenAPI
  description: Retrieve sleep sessions for a user - total, light, deep, and REM
    durations, sleep stages, respiration, heart-rate variability, and readiness or
    recovery metrics - normalized across Oura, Whoop, Garmin, Fitbit, and others.
- aid: terra-api:terra-api-nutrition-api
  name: Terra Nutrition API
  tags:
  - Nutrition
  - Diet
  - Macros
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://docs.tryterra.co/reference/health-and-fitness-api/data-models
  baseURL: https://api.tryterra.co/v2
  properties:
  - url: https://docs.tryterra.co/reference/health-and-fitness-api/data-models
    type: Documentation
  - url: openapi/terra-api-openapi.yml
    type: OpenAPI
  description: Retrieve logged nutrition and dietary intake for a user - meals,
    macronutrients, micronutrients, water intake, and per-meal detail - from apps
    such as MyFitnessPal and other supported nutrition sources.
- aid: terra-api:terra-api-menstruation-api
  name: Terra Menstruation API
  tags:
  - Menstruation
  - Cycle Tracking
  - Womens Health
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://docs.tryterra.co/reference/health-and-fitness-api/data-models
  baseURL: https://api.tryterra.co/v2
  properties:
  - url: https://docs.tryterra.co/reference/health-and-fitness-api/data-models
    type: Documentation
  - url: openapi/terra-api-openapi.yml
    type: OpenAPI
  description: Retrieve menstrual cycle and reproductive health data for a user -
    cycle phases, period days, predicted and actual menstruation events, and related
    symptoms - from cycle-tracking apps and wearables.
- aid: terra-api:terra-api-athlete-api
  name: Terra Athlete API
  tags:
  - Athlete
  - Profile
  - Demographics
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://docs.tryterra.co/reference/health-and-fitness-api/data-models
  baseURL: https://api.tryterra.co/v2
  properties:
  - url: https://docs.tryterra.co/reference/health-and-fitness-api/data-models
    type: Documentation
  - url: openapi/terra-api-openapi.yml
    type: OpenAPI
  description: Retrieve the athlete profile for a connected user - name, age, sex,
    height, weight, country, and other demographic attributes reported by the
    upstream provider - to enrich and contextualize their health data.
- aid: terra-api:terra-api-integrations-api
  name: Terra Integrations API
  tags:
  - Integrations
  - Providers
  - Catalog
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://docs.tryterra.co/reference/health-and-fitness-api/supported-integrations
  baseURL: https://api.tryterra.co/v2
  properties:
  - url: https://docs.tryterra.co/reference/health-and-fitness-api/supported-integrations
    type: Documentation
  - url: openapi/terra-api-openapi.yml
    type: OpenAPI
  description: Discover which of Terra's 500+ wearables, trackers, and health apps
    are available to your account. List supported integrations, and query a detailed
    view filtered by the data scopes and SDKs each provider supports.
- 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.
common:
- 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