Terra

Integration

API
Unified API
SDK
SDK
Authentication
Authentication
Streaming
Streaming
Blood
Blood Report API
Planned Workout
Planned Workout
AI Interface
AI Interface

User engagement

Graph API
Graph API
Scores
Health Scores
Rewards
Health Rewards

Use cases

Enterprise
Enterprise
Insurance
Insurance

Developers

Wearable Data
Wearable Data
Community
Community
Documentation
Documentation

Learn

Blog
Blog
Podcast
Podcast
Events
Events
Reports
Reports

Company

Customers
Customers
Careers
Careers
Partners
Partners
Support
Support
Become an integration
Become an integration


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.

zap

Latest

zap

Popular

API

Unified API

SDK

Phone SDK

Authentication

Widget

Streaming

Streaming

Graph API

Graph API

Can I request months of data with Terra

All

DreadfulGecko25 months ago

When my user first authenticates onto our app, we would like to retrieve the user's entire history of events, is this possible and what is the best approach for this?

terra

Jeffadmin25 months ago

Yes, Terra does support historical backfills. To perform this, you would need to make a http request to our REST api (to the endopoint for the data type you wish to retrieve), for example:

This will request and send the data to your webhook in chunks This method requires a webhook (or other destination) to be configured as the response may be too big for a HTTP request. Whilst this is feasible, it is not advised practice as this will slow down delivery of events to your webhook. Some providers do not allow historical backfill past a certain point (Polar, Garmin, Samsung) and other have strict ratelimits which will result in a longer period before the request is fulfilled.