Concurrent Request Limits

Knowledge Center > Zuora Central > Policies > Concurrent Request Limits

Concurrent Request Limits

Zuora enforces tenant-level concurrent request limits from the user interface and Zuora REST and SOAP API. This policy prevents tenants from monopolizing Zuora system resources.

Concurrent Request Limits

Zuora applies different request limits to different types of request. To learn which request limits apply to each product area, see the tables below.

The request limits are:

  • Total Request limit - 40 concurrent requests by default
    Most UI and API requests are counted towards your Total Request limit.
    Some requests require a large amount of processing or data transfer. The following additional concurrent limits apply to such requests:

    • Big Process Request limit - 20 concurrent requests by default. All big process requests are also counted towards your Total Request limit. The requests that require heavy database operations are big process requests. For example, requests for retrieving payments for a specified account. See Big Process Requests table below for more information.

    • Big Data Request limit - 20 concurrent requests by default. All big data requests are also counted towards your Total Request limit.

  • Custom Request limit - 200 concurrent requests by default. Custom requests are NOT counted towards your Total Request limit.

See the following table for the concurrent request limits that apply to different product areas.

Product Area Operations Total Request Limit Big Data Request Limit Big Process Request Limit Custom Request Limit

Subscriptions

Subscribe and amend REST method calls:

Subscribe and amend SOAP calls, and the corresponding Action calls in the Zuora API Reference:

      checkmarkGreen_xsm.png
Orders

Orders:

  • Preview order
  • Create order
      checkmarkGreen_xsm.png

Orders:

  • All requests except Preview order and Create order
checkmarkGreen_xsm.png      
Login Login Requests:
  • Login API calls (REST and SOAP) 
  • UI login requests

(No applicable concurrent limit for Login requests)

       
HPM

Hosted Payment Method Pages:

      checkmarkGreen_xsm.png
CPQ Zuora 360 Order Builder (includes APEX wrappers for SOAP APIs) checkmarkGreen_xsm.png      
Zuora for Salesforce
  • 360 Sync
  • Zuora Quotes

(No applicable concurrent limit)

       
AQuA AQuA API requests
  • Post query
  • Get job results
  • Get results files
checkmarkGreen_xsm.png      
AQuA results files download checkmarkGreen_xsm.png checkmarkGreen_xsm.png    
Usage

Usage request

  • Post usage
checkmarkGreen_xsm.png checkmarkGreen_xsm.png    

Usage request

  • Check import status
checkmarkGreen_xsm.png      
Data Source Export Data source file download checkmarkGreen_xsm.png checkmarkGreen_xsm.png    
Invoicing

Transactions

  • Get payments
checkmarkGreen_xsm.png   checkmarkGreen_xsm.png  

 

Big Process Requests

SOAP API calls on some objects are handled as Big Process Requests. See the following table for details. The corresponding REST API Actions are also handled as Big Process Requests.

SOAP API Calls Objects
Create invoice
Generate invoice
QueryMore

Account

InvoiceItem

PaymentTransactionLog

RatePlan

RatePlanCharge

RatePlanChargeTier

Subscription

Query

Account

Invoice

InvoicePayment

Payment

PaymentTransactionLog

RatePlan

RatePlanCharge

Subscription

Usage

Errors when Reaching Concurrent Request Limits

You will encounter the following error codes, error messages, or HTTP status codes:

Request Type Error Code Error Message HTTP Status Code - Response Header
User Interface N/A "The total number of concurrent requests has exceeded the limit allowed by the system. Please resubmit your request later."

N/A

REST API 50000070 "The total number of concurrent requests has exceeded the limit allowed by the system. Please resubmit your request later."

HTTP Status:429

Response Header:  “Retry-After:120"

SOAP API, version 51.0 and later

<fns:FaultCode>
REQUEST_EXCEEDED_LIMIT
</fns:FaultCode>

<fns:FaultMessage>
The total number of concurrent requests has exceeded the limit allowed by the system. Please resubmit your request later.
</fns:FaultMessage>

HTTP Status:429

Response Header:  “Retry-After:120"

SOAP API, versions prior to 51.0

<fns:FaultCode>
UNKNOWN_ERROR </fns:FaultCode>

<fns:FaultMessage>
The total number of concurrent requests has exceeded the limit allowed by the system. Please resubmit your request later.
</fns:FaultMessage>

HTTP Status:429

Response Header:  “Retry-After:120"

File Download API N/A "The total number of concurrent requests has exceeded the limit allowed by the system. Please resubmit your request later."

HTTP Status:429

Response Header:  “Retry-After:120"

Zuora recommends that you retry sending the request after 120 seconds.

We recommend that you test your integration in Zuora Sandbox and make sure you do not hit the concurrent limits. Contact Zuora Global Support if you require additional assistance. 

Other Limitations

Limitation on Memo PDF

Up to 20,000 line items are allowed in a single memo PDF.

Limitation on Invoice PDF 

Zuora limits the sum total of certain line items up to a maximum number in a single invoice. For example, the sum total of line items for invoice items, taxation items, and usage items in a single invoice cannot exceed 20,000. 

Maximum sum total of 20,000 is allowed for the following line items:

  • invoice item
  • taxation item
  • usage item

Maximum sum total of 2,000 is allowed for the following line items:

  • credit balance adjustment
  • invoice adjustment
  • invoice item adjustment
  • payment
  • refund

Maximum sum total of 2,000 is allowed for the following line items:

  • subscription
  • rate plan

When generating an invoice PDF, if the maximum number is exceeded, an error message is generated.

Amendments per Subscription

Zuora recommends that you create no more than 100 amendments on a subscription to ensure high performance of the subscriptions. The limit of amendments allowed on a subscription is 1000. However, if you create more than 100 amendments, the performance may be severely degraded, depending on the products and charges set up in your subscription.

If the renewal term period of the latest version of the subscription is Day or Week, the limit of amendments allowed on a subscription is 100.

The 100 amendment limit does not apply to Orders. See Orders Performance Guidance for more information.

Limitations on Orders

The migration to full Orders is in Limited Availability. We are actively soliciting feedback from a small set of early adopters before releasing as generally available.

Zuora has the following limits on Orders to prevent performance degradation:

You can request a limit increase by submitting a request at Zuora Global Support.

Last modified

Tags

Classifications

(not set)