GET Method Deprecated on Some Endpoints

December 07, 2016

Summary

Some API behavior will be changing soon. The following endpoints are affected on the provided dates:

Endpoint Date
/sleep January 4, 2017
/bodymass January 18, 2017
/activity February 8, 2017
/activity_timeseries  
/allday_activity  
/allday_activity_timeseries  

Your app may need to change in order to continue reading data from our API.

Deprecated Capabilities

In the endpoints enumerated above, we are deprecating the broad functionality of the collection GET method i.e. http://developer.underarmour.com/docs/v71_Sleep#collection. Past functionality has allowed fetching any of a user’s data via the CRUD endpoints, but moving forward the only data that we can guarantee is the data created by your application.

This means that only partners who are expecting to read data from sources OTHER than their own will be affected. Partners who are using the UACF platform to store data from their own app and retrieve that data back will not be affected. Any partners who are expecting to read data that was not written by ONLY their app will need to update their code as described below.

If your app is using the UACF Platform simply store and retrieve data, do nothing. Otherwise, if your app reads data that needs to include other providers: update your app’s code to use the /actigraphy endpoint to retrieve the data that is being written with the /sleep, /bodymass, and /activity endpoints. See the documentation for the Actigraphy endpoint here:

http://developer.underarmour.com/docs/v71_Actigraphy

The data that is returned for sleep and activity are governed by the user’s Data Source Priority (bodymass does not currently have a source priority):

http://developer.underarmour.com/docs/v71_Data_Source_Priority.

The Actigraphy endpoint supports GET requests on the collection, returning a document with both aggregates and metrics (time series) data for which the CRUD endpoints, and workouts are data providers.

NOTE: when data comes in from a priority device, it’s data will be added to the response of Actigraphy. From the example shown in the /actigraphy docs, notice the overall totals for a user’s day as well as the time-series data that makes up those totals. You’ll note that the differences between this and the CRUD endpoint output is very minor, so the changes should be easy to implement.

Please reach out to Partner-Support@underarmour.com with any questions or concerns about this change.

LEGACY V3.X API SHUTDOWN ON FEBRUARY 1, 2016

December 31, 2015

Notice to all legacy API users of version before v7.0 that official support will be dropped on February 1, 2016 (one year after the release of v7.0).

In addition all v3.x APIs will be decommissioned and completely removed on February 1, 2016. All clients should have migrated to v7.x.

The rest of our APIs will continue under the support schedule outlined in our Versioning Policy.

As always, let us know if you have questions by using the Help widget on our FAQ page.

UA RECORD™ - THE DEFINITIVE DIGITAL HEALTH AND FITNESS NETWORK

February 02, 2015

We recently unveiled UA Record, a comprehensive health and fitness network, at the Consumer Electronics Show in Las Vegas. Built on the Under Armour Connected Fitness Platform, Record simplifies your personal health data with activity tracking tools, connects you to your digital community, and keeps you synced with your fitness goals 365, 24/7. This is the first digital product launch for Under Armour Connected Fitness and is available now for download on the App Store and the Google Play™ Store.

UA Record offers everyone, regardless of fitness level, the ability to proactively manage their health and fitness through an open platform that’s personalized, easy to use and connected to their everyday lives. Features include GPS activity tracking from mobile sensors and third party devices, analysis from individual workouts and a total snapshot of your progress – including steps, sleep, caloric burn, heart rate, BMI and weight.

A new feature, Personal Challenges, has also been integrated into the UA Record app. Members can invite up to 19 friends within their network to compete in customized health and fitness challenges centered on specific goals. Challenges are based on workout count, total distance, total steps and calories burned. These daily, weekly, or monthly competitions provide real-time updates, leaderboard progress, and an open conversation forum for group participants.

Even more exciting are the features we added to our platform to build UA Record that we’re now opening up to all developers. You can find many new and updated API endpoints powering features found in UA Record, including:

To try out UA Record, download the mobile app for iPhone on the App Store or from the Google Play Store. You can also visit Record.UnderArmour.com to set up an account or login with an existing MapMyFitness or Under Armour account.

Google Play is a trademark of Google Inc.

Introducing Under Armour Connected Fitness

May 17, 2013

Since it was founded 18 years ago, Under Armour has existed on the belief that we can help make all athletes better through passion, design, and the relentless pursuit of innovation. In our first ten years, we created and defined the performance apparel category. The tight-fitting, moisture-wicking, temperature regulating apparel became a staple in closets of athletes everywhere. At the core of our growth story has been the ability to connect with athletes and reinvent performance wear through innovation. So it was no surprise when Under Armour saw the opportunity, the company launched themselves directly in the center of the intersection of sport and technology with the acquisition of MapMyFitness in September 2013.

Now together as one team, Under Armour Connected Fitness, our mission is to make all athletes better with the technology to train, perform, and achieve greatness. Our approach has never waivered – we’re committed to providing an open platform, now named the Under Armour Connected Fitness Platform. This platform provides all of the same technology to build meaningful and state-of-the-art experiences for athletes at all levels. With more than 30 million and growing rapidly, our platform is ready to help you ignite a fitness revolution.

The Under Armour Connected Fitness Platform is built upon the same proven foundation of MapMyFitness. The MapMyFitness API has been used and trusted by hundreds of partners and developers throughout the years.

Our platform supports a full suite of APIs that help you track, inspire, and engage your user base. From 24/7 activity tracking to workout recording to supporting hundreds of devices, our inherently social platform helps you build applications that deliver both performance and fun. Individuals and companies of all sizes have built apps and ecosystems encompassing the data our users have come to love and rely upon as they continue their fitness journey. The platform also powers our entire suite of apps in MapMyRun, MapMyRide, MapMyHike, MapMyWalk, and Under Armour Record.

So now it’s your turn. The time has come to revolutionize fitness. We are working on helping athletes today prepare for tomorrow. We want you to build for the future with a platform that is always one step ahead of the game.

We look forward to hearing from you. As always, thank you for your continued interest and support.