NEW WAYS TO CONNECT WITH UTR SPORTS

Getting Started with Engage API

Getting Started with Engage API

Male tennis player prepares to hit a forehand while wearing Fabletics and improving his UTR Rating, which he can view on Engage API

Ready to get started?

  1. Complete the Developer Application.
  2. UTR Sports responds to you within 7 working days. Approved partners receive access info with highly-restricted rate limits in place.
  3. Reply to the API Developer team with your integration, and you're off!

ADDITIONAL KEY LINKS

Collapsible content

Collapsible content

Women playing pickleball and hugging while improving their UTR Pickleball Ratings at a UTR Sports Golden Ticket

Why become an Engage API partner?

  • Enhance the player experience and further grow the brand initiatives.
  • Enable players to connect with their UTR Sports account
  • Increased exposure to the UTR Rating and event ecosystem
  • Players enjoy better quality rating information on their opponents

ENGAGE API FEATURED PARTNERS

ENGAGE API FAQs

ENGAGE API FAQs

What does the Engage API do?

The Engage API allows cross-platform users (aka users from third-party sites who are also UTR Sports members) to connect their accounts. Once their accounts are connected, third-party sites can hit endpoints hosted within our Engage API service to retrieve player ratings and extended player profile information, as well as post unverified & verified results. Check our Swagger docs for the most up-to-date information on available endpoints - you can sign in with an empty username & password.

Click here to view the complete UTR Sports Engage API Documentation.

What are the prerequisites to utilize UTR Sports Engage API oAuth flow?

To utilize the UTR Sports OAuth flow, you will need the following:

  • Client ID (provided by UTR Sports)
  • Client Secret (provided by UTR Sports)
  • Redirect URI (created by the client and communicated to UTR Sports)

Note that, in addition to a production redirect URI, you may provide us with a development/testing version of your redirect URI that we can whitelist.

Click here to view complete UTR Sports Engage API documentation.

Where can I find the Engage API Brand Guidelines?

Where can I find the UTR Sports API Developer Application?

How do I choose which type of rating to show?

UTR Sports has three different types of ratings: Estimated Ratings, Unverified Ratings, and Verified Ratings.

After players create their UTR Sports profiles, players without match results logged will receive an Estimated UTR Pickleball Rating (P1-P5) or an Estimated UTR Rating, both based on questionnaire answers. With enough matches, these ratings convert to numerical ratings.

The Unverified Rating reflects results from a broader range of event types, including casual play, verified matches, and practice matches. Every result can count towards players' Unverified Ratings, for both the Unverified UTR-P Rating and Unverified UTR Rating.

The Verified Rating, for both UTR-P and UTR Rating, reflects results from only verified third-party event providers and tournament directors.

The Verified Rating is the most accurate rating available from UTR Sports. When deciding which rating to display in your app, UTR Sports recommends choosing the Verified Rating (if available), followed by Unverified, followed by Estimated. But the best rating to display is ultimately up to the needs of your product.

Which decimals are visible for UTR and UTR-P ratings within the API?

Engage API seamlessly integrates UTR and UTR-P ratings, giving your players access to take their ratings with them wherever they play and track their performance. The behavior breakdown is based on their UTR Sports Power subscription status and sport.

For the UTR Rating (tennis)

Power Users will see:

  • 2 decimal ratings for all players in the UTR Sports app
  • 2 decimal ratings for themselves and other Power users on your platform
  • Integer ratings for other free users on your platform

Free Users will see:

  • 2 decimal ratings for themselves in the UTR Sports app
  • Integer ratings for all other players in the UTR Sports app
  • 2 decimal ratings for Power users on your platform
  • Integer ratings for themselves and other free users on your platform

For the UTR-P Rating (pickleball), which only has one decimal, integer ratings will be visible to all users across the UTR Sports app and on your platform.

How often can I sync ratings?

How often you sync ratings is ultimately up to the needs of your application. UTR Sports' ratings update daily, so there's no need to sync more frequently than once every 24 hours.

Can I sync ratings for anyone on the platform?

Yes and no. In order to be able to sync ratings and post results, your users need to connect via OAuth and authorize access to read & write their data on UTR Sports.

So you can sync ratings for anyone on the platform, as long as they have connected their account and granted your application access.