Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
| Page Tree Search |
|---|
Overview
You can lookup a USTA player play history membership status given a USTA uaid. Play history contain the players previously played matches and results. The player history can be called on demand or incrementally if partner decided to store the data in there application. API will provide membership status information i.e. active, inactive, cancelled etc.
API
This API is called once per player.
URI
| Code Block |
|---|
POST https://api-ustaconnect.usta.com/v1/api-public/membership/playhistorystatus |
Body
| Code Block |
|---|
{ "selection": { "uaid": "2006874790", "fromDate": "2023-07-09", "toDate": "2024-02-25" }, "pagination": { "currentPage": 1, "pageSize": 1 } }"2017000162" } |
Response
One player play history is returned per call.
| Code Block |
|---|
{
"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
}
membershipStatus": "ACTIVE"
} |
Sample Curl
You must first retrieve an access token using Bound or Unbound method. See Cognito Client Integration Guide for more on how to request a token.
The following is a sample curl to retrieve a player play historymembership status.
Where:
--header 'Authorization: Bearer eyJraW...
specifies the token that you retrieved using the https://account-ustaconnect.usta.com/oauth2/token endpoint.
| Code Block |
|---|
curl --location 'https://api-ustaconnect.usta.com/v1/api-public/membership/playhistorystatus' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer eyJraW... --data '{ "selection": { "uaid": "1076966", "fromDate": "2000-07-09", "toDate": "2024-07-10" }, "pagination": { "currentPage": 1, "pageSize": 1 } }"2017000162" }' |
| Panel | ||
|---|---|---|
| ||
On This Page: |
| Table of Contents |
|---|
| Panel | ||
|---|---|---|
| ||
More Reading: |