Request

Response

    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.

    OperationMethod + EndpointRate 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.

    OperationMethod + EndpointRate 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.

    OperationMethod + EndpointRate 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.