API Limits

API Limits

Our APIs are rate limited to prevent abuse and ensure service stability. These limits are administered within CustomBooks™.

Rate Limits

Rate limits control the number of API calls your Application (identified by Client ID) can make within a given time period. If this limit is exceeded, the API requests may fail.
There are limits to the number of API calls that your application can make to a particular CustomBooks™ company.
This applies to your Playground and the Live companies.

Daily Limit: 5000 calls per 24 hours.
Second Limit: 1 call per second.

If you exceed the limits, you may receive a HTTP 503 (Service Unavailable) response.

Best practices

a) If you exceed the limits, do not continue to make requests, as this may extend the wait window and call count. Include code that catch such errors.
b) We recommend your using a queuing mechanism and allow a few seconds before attempting another request.
c) Spread out or regulate the API call rate.

Request Size Limits

A POST request has an overall size limit of 3 MB. 
Any request taking more than 2 minutes to respond will time out.
This limit does not apply to the APIs file read.

Best practices

a) For larger requests, we recommend your creating smaller batches of records to POST.
b) Use filters to limit the response size and avoid overlapping data requests.
c) Use caching for data that your app uses often.

Application Limits

For a given CustomBooks™ company, you can connect only one application independent of the user authorizing the company access.

Best Practices

When testing, use Playground Applications. 

Platform Limits

There can be other factors that may limit the CustomBooks™ platform API access. Some of these factors for a given CustomBooks™ company are:
a) Company's plan upgrade or downgrade.
b) Company's plan cancellation or Payment failures. 
c) Authorizing User's role/permission changes.
d) Maintenance Downtime.

Have Custom Rate Limit Needs?

Please connect with our Integrations Partner Manager to discuss your needs.

    • Related Articles

    • API Security

      Shared Responsibility At CustomBooks™ we take data security seriously, and we expect our Integration Partners to use the best efforts in securing our user data. Our responsibility is to ensure that CustomBooks™ products and services are secure. Your ...
    • Where can I find API Authentication (OAuth 2.0) Information like the secret key?

      The apisecret key may be found by the following: 1) Click Settings 2) Click the Integrations Tab The key is at the top of the integrations tab. There is API documentation found here: https://developer.accountingsuite.com/.
    • AccountingSuite™ Release Notes, German Shepherd 4, Gusto and ShipStation Integrations

      AccountingSuite™ is now  integrated with Gusto and Shipstation! Import your payroll information into AccountingSuite™ Error free entry into AccountingSuite™ using Gusto’s API. We have created an easy payroll sync from Gusto that allows you to sync ...
    • Cloud Banking: US Bank to migrate to open banking

      US Bank Users: On September 6th, 2023 our financial service aggregator will be migrating US Bank to Open Banking. Re-authentication will be needed before September 30th, 2023. What is Open Banking? Open Banking is a faster, more reliable, more ...
    • Using an External Business Intelligence Tool

      Using an External Business Intelligence Tool CustomBooks™has a financial and usage reporting API which may be used with external tools to create customized reports. The technical documentation for the API is located here. You may find examples of its ...