• Unified API
  • Mobile SDK
  • Connection Widget
  • Streaming
  • Blood Report API
  • Graph API
  • Health Scores
  • Health Rewards
  • Planned Workouts
  • Lab Testing
  • AI Interface
  • Enterprise
  • Insurance
  • Integrations
  • Research
  • Podcast
  • Blog
  • Reports
  • Events
  • Documentation
  • Community
  • Example apps
  • Wearable Data
  • About
  • Customers
  • Partners
  • Careers
  • Support
  • Pricing
Terra
Pricing
Become an integrationGet started

XOSS API Integration

With Terra's XOSS web API integration, your app receives the rides and runs users record on XOSS GPS computers and heart rate straps. Terra normalizes each session, covering GPS route, distance, duration, speed and heart rate, and POSTs it to your webhook.

Start Receiving Data From XOSS In 5 Minutes

XOSS

XOSS

Enable XOSS through your Terra dashboard

Select a Wearable

XOSS

XOSS

Connect users to your app

0. "active_durations_data":{...}
1. "calories_data": {...}
2. "device_data": {...}
3. "distance_data": {...}
4. "heart_rate_data": {...}
5. "movement_data": {...}
6. "position_data": {...}

Start receiving data from XOSS on your app or website

How the XOSS API integration works

Data delivery
Terra polls XOSS
Expected latency
Up to 5–10 minutes after the provider syncs
Data types
Activity
Credentials
No provider credentials required

Two ways to receive XOSS data

When data is available from a XOSS device, Terra sends it straight to your webhook. During your Terra account setup you'll be prompted for a callback URL, and that is where Terra POSTs each payload.

XOSS does not notify Terra when data changes, so Terra polls it every 5–10 minutes for each connected user and POSTs the normalized payload to your webhook.

XOSS's Activity
Payload Preview

Terra API preserves the raw data from the wearable, it just standardizes the units and the json format. It doesn’t augment or change the raw data in any way.

Data is organized into one of 6 data types.

Learn More

XOSS's Available Data Types

Activity Payload (JSON)

{

active_durations_data: { ... }

calories_data: { ... }

data_enrichment: { ... }

distance_data: { ... }

heart_rate_data: { ... }

metadata: { ... }

movement_data: { ... }

}

Data can also be sent as a FIT File or with the FHIR Format.

Send XOSS data to your backend

Terra forwards every normalized payload to the destination you already use.
WebhookWebhook
FirestoreFirestore
SQLSQL
Mongo DBMongo DB
Google Cloud Storage BucketGoogle Cloud Storage Bucket
WebhookWebhook
FirestoreFirestore
SQLSQL
Mongo DBMongo DB
Google Cloud Storage BucketGoogle Cloud Storage Bucket
AWS S3 BucketAWS S3 Bucket
AWS Simple Queue ServiceAWS Simple Queue Service
KafkaKafka
SupabaseSupabase
Azure BlobAzure Blob
AWS S3 BucketAWS S3 Bucket
AWS Simple Queue ServiceAWS Simple Queue Service
KafkaKafka
SupabaseSupabase
Azure BlobAzure Blob

People Often Ask Us...

How do I access XOSS data through an API?

Your user connects their XOSS account through the Terra widget, and Terra reads the rides and runs recorded on XOSS GPS computers and heart rate straps, normalizing each session into a standard Activity payload for your webhook.

How quickly does XOSS data reach my app?

Terra polls XOSS every 5–10 minutes for each connected user, so new data reaches your webhook within that window of a device sync.

What data is available from XOSS through Terra?

Through Terra's XOSS integration, you can access activity data.

Which XOSS devices are supported?

Everything that syncs into the XOSS app, including the G+ GPS and NAV bike computers, the X1 and X2 heart rate monitors, the HRM armband and Vortex strap, and the speed and cadence sensors.

What does an XOSS session return?

GPS route, distance, duration, speed and heart rate, normalized into the same Activity shape Terra uses for every other provider.

Can't Find Your Question?

What devices are supported?

Terra API integrates with any XOSS device currently supported by XOSS.

X2 HRM Chest Strap
HRM Armband
Vortex HRM
G+ GPS
NAV
X1 Heart Rate Monitor
Speed Sensor
Cadence Sensor

Connect with our XOSS Integration

XOSS API alternatives

These integrations also offer Activity data.

Wahoo

Wahoo

Peloton

Peloton

Bryton

Bryton

MapMyFitness

MapMyFitness

MapMyRide

MapMyRide

MapMyRun

MapMyRun

MapMyWalk

MapMyWalk

Strava

Strava

Ask, Learn, and Connect

Explore the community forum and connect to Terra API with ease.

Ask a Question

The world's best health apps run on Terra data

Get started
ProductsIntegrations AI Interface Authentication Mobile Development Documentation GraphAPI
DocumentationAPI SDK Quickstart
CommunityBlog Research Community Podcast Github
CompanyAboutCareersCustomersBecome an IntegrationCookies PolicyGDPRPrivacy PolicyTerms of Purchase
© Terra API. 2026 — All rights reserved.

Cookie Preferences

Essential CookiesAlways On
Advertisement Cookies
Analytics Cookies

Crunch Time: Embrace the Cookie Monster Within!

We use cookies to enhance your browsing experience and analyse our traffic. By clicking “Accept All”, you consent to our use of cookies according to our Cookie Policy. You can change your mind any time by visiting out cookie policy.

Cookies Policy