Connect with Core

Terra's Core API integration will allow your app to collect data from the Core platform, and gain insights into the number of calories burned for a user, the power they generate on their rides, and more. Through the Core API integration, your app can use these data keep users active, and pull detailed workout metrics for analysis.

Start Receiving Data From Core In 5 Minutes

Core

Enable Core through your Terra dashboard

Select a Wearable

Core

Connect

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 Core on your app or website

You Can Receive...

Recent Data with Webhooks

Historical Data with HTTP Requests

When data is available from an Apple device, it will be streamed to you via our webhooks. During your Terra account setup, you'll be prompted to provide a callback URL, allowing Terra to PUSH data using POST requests.

You may also use HTTP requests with your Apple integration in case you wish to request historical data or data over extended periods of time.

Our Apple integration with Terra offers instant data delivery, eliminating the need for periodic requests. Apple notifies Terra whenever new data is available, and we then POST the normalized data to your webhook.

Most HTTP endpoints can take additional parameters start_date and end_date which allow you to request data over a specific period for the given user.

Core's
Body

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

Core's Avaliable Data Types

Body Payload (JSON)

{

heart_data: { ... }

metadata: { ... }

temperature_data: { ... }

}

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