Play Activity Reference Guide

Owned by Jonathan Cohen
Last updated: Nov 07, 2022
2 min read

Overview

The following page describes the contribution of players and play activity to USTA. Play activity that qualifies to be incorporated into the World Tennis Number (WTN) will be automatically sent to the ITF. Calculation of WTN occurrs once per week on Wednesday AM GMT.

The Play Activity API operates only in Unbound mode. Code must implemented server-side in the calling application.

Player profiles contributed via API will not be visible on usta.com or via the API. The player can go to usta.com to claim their account to make their account visible and eligible for registration in USTA events.

USTA Customer Accounts

Every player must have a USTA UAID in order to contribute play activity to USTA. 3rd party applications can create Player accounts provided:

  1. They dont already exist.

  2. That the user participant first accepts the USTA terms and conditions statement.

If an account is found matching FNAME, LNAME, GENDER, DOB, then their existing UAID will be returned.

Adult/13 And Over Players

Adults and junior players age 13 and over can created via the API or on http://usta.com

Under 13 Players

Because children under 13 must have their account attached to an adult parent or guardian, this relationship must be managed on http://usta.com . Unlike adults, play activity for U13 players can be contributed via API only after the parent-child relationship has been established and UAIDs have been assigned to the U13 player. These players cannot be created via the API. The parent must create the junior player on http://usta.com .

Play Activity

Play activity is contributed on a per matchup basis. All match participants must have a USTA UAID in order for the matchup to be successfully contributed.

Player Profile

Your application can lookup the most up-to-date player profile information including NTRP and WTN ratings for a given UAID. Player profile data can change at any time. Applications should not store or cache profile or rating data.

File-Based Contribution

Players and Play Activity can be contributed in bulk using CSV files dropped to AWS S3.

This is handy to seed USTA with existing data.

Â