Play Activity Reference Guide
- Jonathan Cohen
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.
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:
They dont already exist.
That the user participant first accepts the USTA terms and conditions statement.
Player accounts can be created from within a 3rd party application using the API for all adults and players age 13 and up.
Players can visit http://usta.com to create a player account:
Click ‘Join’ on the main landing page
Choose an account type (ie ‘Player’)
Click ‘Sign Up’ on the Login Screen
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.