Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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.

Info

WTN tennisNumbers are published on Wed am UTC. Only the most recently recorded WTN will be returned. 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.

...

Code Block
{
    "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.

Info

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 bucketed into low/medium/high. 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