Crunch Time: Embrace the Cookie Monster Within!
We use cookies to enhance your browsing experience and analyse our traffic. Nothing beyond essential cookies runs until you choose. You can change your mind any time in our Cookie Policy.
Start Receiving Data From TrainerRoad In 5 Minutes
TrainerRoad
Enable TrainerRoad through your Terra dashboard
Select a Wearable
TrainerRoad
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 TrainerRoad on your app or website
How the TrainerRoad API integration works
- Data delivery
- Terra polls TrainerRoad
- Expected latency
- Up to 5–10 minutes after the provider syncs
- Data types
- Activity, normalized by the Terra unified API
- Credentials
- No provider credentials required
Two ways to receive TrainerRoad data
When data is available from a TrainerRoad 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.
TrainerRoad 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.
TrainerRoad'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
Activity Payload (JSON)
{
metadata: { ... }
distance_data: { ... }
position_data: { ... }
active_durations_data: { ... }
movement_data: { ... }
calories_data: { ... }
work_data: { ... }
power_data: { ... }
energy_data: { ... }
heart_rate_data: { ... }
polyline_map_data: { ... }
data_enrichment: { ... }
}
Data can also be sent as a FIT File or with the FHIR Format.
Send TrainerRoad data to your backend
Terra forwards every normalized payload to the destination you already use.
Webhook
Firestore
SQL
Mongo DB
Google Cloud Storage Bucket
AWS S3 Bucket
AWS Simple Queue Service
Kafka
Supabase
Azure BlobPeople Often Ask Us...
Can't Find Your Question?
What devices are supported?
Terra API integrates with any TrainerRoad device currently supported by TrainerRoad.
TrainerRoad API alternatives
These integrations also offer Activity data.
