Help

Developer FAQ

Is There Another Way To Authenticate For The API Other Than OAuth2?

No, not at this time.

What Features Does The UACF API Have?

Please refer to the UACF documentation found here. All information about accessible data is documented for your reference.

I Receive A 302 (Redirect) – Why Is That?

You probably forgot to put a / on the end of the URL. For collections, use v7.0/<endpoint>/ and for items use v7.0/<endpoint>/<id>/.

Is There A Difference Between A “Client” And “Consumer”?

A Consumer Key and Client ID are the same thing. A Consumer Secret and Client Secret are the same thing. The terminology “Client” is being used for OAuth2.

How Should I Use The API For Routes / Activity / Groups For Events?

We often work with races and sporting events. Through our API you can have access to specific routes and activity. If you are interested in partnering for an event, please contact support at Partner-Support@underarmour.com.

Can You Search For Individual Users (Via E-Mail Address) Through The API?

No, not at this time.

Can You Create Groups / Challenges On The API?

No, not at this time. This is coming soon, please stay tuned.

What Is A Typical Expiration Date For OAuth2 Tokens?

The typical expiration date for OAuth2 tokens is every 60 days, but we deserve the right to change this. You can find this information in the access token response.

Do You Provide TCX Upload Support?

This is a highly requested feature, and is coming soon. Thanks for your patience.

Does The API Provide Distinction With Verified And Non-Verified Activity, And How Do I Distinguish This?

Yes. This information can be found in the source field. If you’re seeing persistent errors (receiving an error response), please contact our support team.

Do You Provide Data Sets For Academic Research Purposes?

We have participated in past research studies. If you are interested, please please contact our support team.

How Will I Know If A Token Expires?

You will receive a 401 error, and it will tell you it has expired.

What Is The Max (Scale) Of Daily Requests?

Our standard API accounts have a max 25,000 requests/day and 60 requests/second. If you would like to increase your requests (quota or rate limit increase), please contact our support team and we will get back with you. Please list in your ticket: How many requests you need, what company you work for, and the purpose for extended access.

I’m Having Trouble With Your Timezones

Our TZ manipulation library (pytz) relies on the Olsen database. You can view more information about the database here http://en.wikipedia.org/wiki/List_of_tz_database_time_zones.

I’m Seeing OAUTH_1 Errors When Trying To Use OAuth2. Why?

Make sure you’re using https://oauth2-api.mapmyapi.com/ for OAuth2. Also make sure that you are using an “Api-Key” header with your OAuth2 client_id and an “Authorization” header with any access token you have. If you do not yet have an access token, make sure your access token request follows the example in the OAuth2 demo on developer.underarmour.com.

Question: Do I Need A Scope / How Do I Use Them?

No, we are currently not using scopes.

Do You Have API Examples Available?

If you are interested in seeing UACF API examples, visit Github:

https://github.com/mapmyfitness/api-examples

I Have Received A “Developer Inactive” Response. What Does This Mean?

Make sure your OAuth2 request includes an “Api-Key” header with your client ID and that your request is using the host https://oauth2-api.mapmyapi.com.

Problem: I Get A “Callback_uri Didn’t Match” Error

Make sure your callback uri matches exactly, query strings that vary will result in this error. Information that you may want to put in query strings should be url encoded and anything you want passed back needs to be put in the “state” parameter.

Problem: Migration From OAuth1 To OAuth2, And Receive A 403 Error On API Request

Make sure you’re delivering the credentials in the “Authorization” header, not the body.

Request For Enterprise API Access

If you need Enterprise API, put your request here. We will need: company, application, target audience, scale of use (requests per second and expected number of requests per day).

Do You Offer SDKs In Platforms Other Than Mobile?

No, not at this time. Check back here for future enhancements or consider signing up for an Enterprise account for access to special features.

What Is The Difference In A Basic API Access Versus Enterprise API Access?

Consumers with an Enterprise account may have higher request limits. An Enterprise account is probably best if you anticipate a large user group. Features are basically the same between the two.