| Version | Date | Comment |
|---|---|---|
| Current Version (v. 9) | Jul 29, 2022 15:22 | Jonathan Cohen |
| v. 19 | Aug 29, 2022 23:49 | Jonathan Cohen |
| v. 18 | Aug 29, 2022 18:26 | Jonathan Cohen |
| v. 17 | Aug 29, 2022 18:03 | Jonathan Cohen |
| v. 16 | Aug 16, 2022 20:59 | Jonathan Cohen |
| v. 15 | Aug 10, 2022 17:32 | Jonathan Cohen |
| v. 14 | Aug 08, 2022 19:35 | Jonathan Cohen |
| v. 13 | Jul 29, 2022 15:43 | Jonathan Cohen |
| v. 12 | Jul 29, 2022 15:41 | Jonathan Cohen |
| v. 11 | Jul 29, 2022 15:31 | Jonathan Cohen |
| v. 10 | Jul 29, 2022 15:29 | Jonathan Cohen |
| v. 9 | Jul 29, 2022 15:22 | Jonathan Cohen |
| v. 8 | Jul 29, 2022 15:19 | Jonathan Cohen |
| v. 7 | Jul 29, 2022 15:10 | Jonathan Cohen |
| v. 6 | Jul 13, 2022 18:56 | Jonathan Cohen |
| v. 5 | Jul 12, 2022 18:32 | Jonathan Cohen |
| v. 4 | Jul 12, 2022 17:01 | Jonathan Cohen |
| v. 3 | Jul 11, 2022 19:48 | Jonathan Cohen |
| v. 2 | Jul 11, 2022 19:17 | Jonathan Cohen |
| v. 1 | Jul 11, 2022 19:17 | Jonathan Cohen |
Overview
You can lookup a USTA player profile given a USTA uaid. Tne player profile should be called on demand rather than storing the profile within your application. Data within the profile changes frequently and can become stale quickly.
WTN tennisNumbers are published on Wed am UTC as reflected by the ratingDate field. Only the most recently recorded WTN will be returned for each play type. WTNs corresponding to Singles and Doubles could correspond to different ratingDates if the player has not recorded play activity.
API
This API is called once per player.
URI
https://services.usta.com/v1/dataexchange/profile/search?limit=1
Body
{
"selection":{
"uaid":"2006874790"
},
"output":{
"ratings":true,
"wtn":true
}
}
Response
One customer profile is returned per call.
{
"data": [
{
"name": "Adelle Parant",
"uaid": "2006812345",
"isPrimaryResidenceDeclaration": "N",
"city": "Tarzana",
"section": {
"code": "65",
"name": "Southern California"
},
"district": {
"code": "17",
"name": "Southern California",
"sectionCode": "65"
},
"state": "CA",
"zipcode": "91356-3105",
"gender": "FEMALE",
"ageCategory": "ADULT",
"subscription": {
"membershipStatus": "ACTIVE",
"expiryDate": "2023-03-31T23:59:59-0400"
},
"wheelchair": false,
"ratings": {
"ntrp": {
"ntrpRating": 3.5,
"ratingType": "C",
"ratingDate": "2021-12-31T00:00:00",
"ratingExpiration": "2024-12-31T00:00:00",
"updatedAt": "2021-12-31T00:00:00",
"ratingYear": 2021
},
"ballColorRating": null,
"competitionLevelBallColor": null,
"wtn": [
{
"type": "SINGLE",
"tennisNumber": 21.56,
"confidence": 10,
"ratingDate": "2022-07-06",
"gameZoneUpper": 19.53,
"gameZoneLower": 23.6,
"source": "SEED",
"lastPlayed": "2018-06-03",
"uaid": "2006874790",
"tennisId": "PAR9979473",
"updatedAt": "2022-07-06T09:39:24",
"proZone": false
},
{
"type": "DOUBLE",
"tennisNumber": 23.65,
"confidence": 100,
"ratingDate": "2022-07-06",
"gameZoneUpper": 21.9,
"gameZoneLower": 25.39,
"source": "MATCHUPS",
"lastPlayed": "2022-06-21",
"uaid": "2006874790",
"tennisId": "PAR9979473",
"updatedAt": "2022-07-06T09:39:24",
"proZone": false
}
]
},
"itfTennisId": "PAX9979123"
}
]
}
Handling WTN In The Client Application
There are some key points to note about display of WTNs. When a tennisNumber is calculated, there is a confidence level assigned to it indicating low/medium/high confidence. There are many factors that go into the confidence rating such as frequency of play and how recently the player has recorded a score.
Each WTN is distributed with a confidence level indicating low/medium/high confidence that the tennisNumber reflects the current level of player.
Confidence Level
Confidence levels are recorded in increments of 10 and bucketed into low/medium/high categories. Each application needs to decide how to indicate whether a tennisNumber is supported by confidence level or not.
Level | Number |
|---|---|
Low | 10-40 |
Medium | 50-60 |
High | 70-100 |