Hammerhead API Integration
With Terra's Hammerhead web API integration, your app can access detailed cycling performance data from Hammerhead's Karoo GPS cycling computers. The integration delivers ride metrics including GPS routes, power output, heart rate, cadence, speed, elevation, and calories burned for every ride.Start Receiving Data From Hammerhead In 5 Minutes
Hammerhead
Enable Hammerhead through your Terra dashboard
Select a Wearable
Hammerhead
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 Hammerhead on your app or website
How the Hammerhead API integration works
- Data delivery
- Terra polls Hammerhead
- Expected latency
- Up to 5–10 minutes after the provider syncs
- Data types
- Activity
- Credentials
- No provider credentials required
Two ways to receive Hammerhead data
When data is available from a Hammerhead 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.
Hammerhead 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.
Hammerhead'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)
{
active_durations_data: { ... }
data_enrichment: { ... }
metadata: { ... }
}
Data can also be sent as a FIT File or with the FHIR Format.
Send Hammerhead 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 Hammerhead device currently supported by Hammerhead.
Hammerhead API alternatives
These integrations also offer Activity data.
Cookie Preferences
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.