SSA API Rate Limits
The Secure Service Account (SSA) API implements rate limiting to ensure fair access and prevent resource abuse. This page details the specific rate limits for each SSA operation.
Note: For general information about APS rate limits and quotas, see APS Rate Limits and Quotas.
Overview
All SSA API operations are subject to rate limits that restrict the number of requests per minute. Rate limits are applied per application (identified by Client ID) and per API endpoint.
Key Points:
- Current limit: All operations are limited to 10 requests per minute
- Scope: Limits apply per application per endpoint
- Error response: Exceeding limits returns
HTTP 429 Too Many Requests - Service availability: Rates may be further reduced during high system load
What Happens When You Exceed the Limit?
When your application exceeds a rate limit, the SSA service returns an HTTP 429 Too Many Requests error. Refer to the Rate Limits section in APS Rate Limits and Quotas for details on handling these responses.
Note: Rate limits are not service-level guarantees. During periods of high system load, actual accepted request rates may be lower than the documented limits.
API Rate Limits by Category
Account Management Operations
Operations for creating, reading, updating, and deleting service accounts.
| Operation | Method + Endpoint | Rate Limit |
|---|---|---|
| Create Service Account | POST /service-accounts | 10 requests per minute |
| Get All Service Accounts | GET /service-accounts | 10 requests per minute |
| Get Service Account | GET /service-accounts/{serviceAccountId} | 10 requests per minute |
| Enable or Disable Service Account | PATCH /service-accounts/{serviceAccountId} | 10 requests per minute |
| Delete Service Account | DELETE /service-accounts/{serviceAccountId} | 10 requests per minute |
Key Management Operations
Operations for managing cryptographic keys associated with service accounts.
| Operation | Method + Endpoint | Rate Limit |
|---|---|---|
| Create Keys | POST /service-accounts/{serviceAccountId}/keys | 10 requests per minute |
| Get All Keys | GET /service-accounts/{serviceAccountId}/keys | 10 requests per minute |
| Enable or Disable Key | PATCH /service-accounts/{serviceAccountId}/keys/{keyId} | 10 requests per minute |
| Delete Key | DELETE /service-accounts/{serviceAccountId}/keys/{keyId} | 10 requests per minute |
Token Exchange Operations
Operations for exchanging JWT assertions for access tokens.
| Operation | Method + Endpoint | Rate Limit |
|---|---|---|
| `Exchange JWT Assertion for Token`_ | POST /token | 10 requests per minute |
Best Practices
For guidance on working within these limits — retry logic with exponential backoff, token and response caching, distributing requests, polling intervals, and monitoring your 429 rate — see the Best Practices Developer’s Guide topic.