Overview
The USTA API provides a toolkit for accessing USTA data from properly credentialed partner applications. The API is organized around RESTful calling style that works with standard HTTP calls. All requests should be made over SSL. All requests and responses as well as errors are encoded in JSON. This document provides developers with an introduction to integrating your application with the USTA API.
Credentials
This is a secure API and requires credentials to accessing the data. The USTA must issue credentials prior to using the API. If you require credentials, please contact USTA.
Endpoints
The simplest way to access the API is via use of cURL. Any language or client that supports HTTPS can be used to call the API.
Rate Limiting
The USTA institutes per-month, per-hour, per-minute, and per-IP rate limits for each API method, and limits API users to a maximum of five concurrent connections from a single IP address. Our default limits are more than sufficient for nearly all use cases. Please be mindful of these limits.
Rate limited calls may result in HTTP error status 403 responses.
Lookup Behavior
Standard behavior when looking up elements in the API result in HTTP error status 404 NOT FOUND when an element does not exist. In some cases, an API can result in HTTP status 200 where the result will contain an empty result set. Where the behavior deviates, the API reference will denote the behavior,
Error Codes
The USTA API follows standard HTTP error status protocols. Please note that all valid responses will return an HTTP status code of 200.
You can see the complete list of error codes here.