Parameters API Rate Limits and Quotas
The Parameters API observes a set of rate limits to ensure that all clients get sufficient service and that runaway applications don’t consume excessive resources. You’ll find general information about rate limits in APS Rate Limits and Quotas.
These rate limits apply across all of the Parameters API’s endpoints, although they’re separately set for each requesting application (specified by the client ID). Note that these rates are not service guarantees. In the uncommon case where total service use is too high across all clients, accepted request rates may drop until traffic subsides.
Endpoint Groups
Different rate limits apply to the different types of parameter endpoints. Parameter endpoints with /parameters/v1/accounts/ in the base URL have a limit of 300 requests per minute, and other endpoints has a limit of 14000 requests per minute.
Rate Limits for Parameters API Endpoints
The following table describes the rate limits for endpoints within the Parameters API:
Endpoints | Limit (Requests/minute) | Scope |
---|---|---|
All endpoints with /parameters/v1/accounts/ in the base URL | 300 | Per application (specified by client ID) |
All endpoints with /parameters/v1/disciplines in the base URL | 14000 | All applications (client IDs) across all /parameters/v1/disciplines endpoints |
All endpoints with /parameters/v1/specs in the base URL | 14000 | All applications (client IDs) across all /parameters/v1/specs endpoints |
All endpoints with /parameters/v1/units in the base URL | 14000 | All applications (client IDs) across all /parameters/v1/units endpoints |
All endpoints with /parameters/v1/classification/ in the base URL | 14000 | All applications (client IDs) across all /parameters/v1/classification/ endpoints |
Scope
The Parameters API measures requests per application as specified by the Client ID for all endpoints with /parameters/v1/accounts/ in the base URL. All other endpoints are tracked globally, independent of any given Client ID.
Violation Notification
If an application exceeds an endpoint group’s rate limit, the Parameters API returns an HTTP 429 error (described in detail in APS Rate Limits and Quotas).
Changing Limits
APS Rate Limits and Quotas describes how to request rate limit changes for APS APIs.