Fetch USTA Play History By Player
Overview
USTA provides limited access to play history
Scores are formated in an array of sets with the following format:
7, # Side 1 Games
6, # Side 2 Games
10, # Side 1 Tie Break Score
6 # Side 2 Tie Break Score
API
Endpoint
POST https://api-ustaconnect.usta.com/v1/api-public/playhistoryBody
A USTA uaid and date range are required.
{
"selection": {
"uaid": "2006874790",
"fromDate": "2023-07-09",
"toDate": "2024-02-25"
},
"pagination": {
"currentPage": 1,
"pageSize": 1
}
}Return
The deep link to the most current USTA terms and conditions on http://usta.com . The calling application should redirect to this ungated landing page
Once the participant consents, there is no need to present the terms again.
{
"uaid": "2006874790",
"player_name": "Thrxxx Laxxx",
"events": [
{
"eventId": "1009414975",
"flightName": "Adult 40&Over",
"level": "0.0",
"name": "2023 Adult 40 & Over 3.0 - 5.0 - Weekend/5.0 Women (Open)",
"displayName": "1009414975",
"startDate": "2023-01-27",
"endDate": "2023-05-07",
"matchFormat": "SINGLES",
"matchUrl": "https://tennislink.staging.usta.com/Leagues/Main/StatsAndStandings.aspx?t=R-17&search=1009414975",
"url": "https://tennislink.staging.usta.com/Leagues/Main/StatsAndStandings.aspx?t=R-17&search=1009414975#&&s=4||0||90458||2023",
"matchDate": "2023-04-02",
"subFlightName": "5.0 Women (Open)",
"eventType": "LEAGUE",
"facility": {
"name": "Overland Park Racquet Club",
"addressLine1": "6800 W 91st St",
"addressLine2": "",
"city": "Overland Park",
"state": "KS",
"zipcode": "66212"
},
"matchStatus": "Defaulted",
"matchStatusCode": "DEF",
"itf_matchup_id": "",
"captain": "Jackie Gehrke",
"coCaptain": "",
"rounds": [
{
"eventId": "1009414975",
"positionOfPlay": "1S",
"positionOfPlayDisplay": "1S",
"playerName": "Thrxxx Laxxx",
"teamName": "Gehrke, Jackie",
"teamCaptain": "Jackie Gehrke",
"teamCoCaptain": "",
"opponentTeamName": "Fabrizius, Deborah",
"matchStatus": "Defaulted",
"matchStatusCode": "DEF",
"outcome": "W",
"ustaScore": [
[
6,
0,
0,
0
],
[
6,
0,
0,
0
]
],
"opponentsName": "",
"opponents": []
}
]
}
],
"pagination": {
"currentPage": 1,
"pageSize": 1,
"totalPages": 33,
"totalResults": 33
}
}Sample Curl
You must first retrieve an access token using Bound or Unbound method. See https://ustadigital.atlassian.net/wiki/spaces/DEV/pages/1001095380 for more on how to request a token.
The following is a sample curl illustrating the contribution of a doubles matchup.
Where:
--header 'Authorization: Bearer eyJraW...
specifies the token that you retrieved using the https://account-ustaconnect.usta.com/oauth2/token endpoint.