1. Introduction
Commusoft developer
  • Introduction
    • Introduction
    • Key concepts and relationships
    • Authentication
    • Rate-limits
    • Requests and responses
    • Core concepts and patterns
    • Support and technical support
  • CRM
    • Properties
      • List customer types
      • List properties
      • Properties
      • Customers
      • Companies
      • Work addresses
      • Customers
      • Companies
      • Work addresses
      • Properties
    • Contacts
      • List property contacts
      • Property contacts
      • Property contacts
      • Property contacts
    • Assets
      • Understanding assets
      • List asset groups
      • List asset types
      • Asset structure
      • Assets dynamic fields
      • List assets
      • Assets
      • Assets
      • Assets
      • Assets
    • Scheduled activities
      • List scheduled activities
      • Scheduled activities
      • Scheduled activities
      • Complete Scheduled Activity
      • Scheduled activities
    • Search
      GET
  • Sales
    • Opportunities
      • List opportunity pipelines
      • List opportunity stages
      • List opportunities
      • Opportunities
      • Opportunities
      • Opportunities
      • Opportunities
    • Actions
      • Change opportunity stage
  • Jobs
    • Jobs
      • List job description templates
      • List jobs
      • Jobs
      • Jobs
      • Jobs
      • Jobs
    • Forms
      • List forms
    • Actions
      • Change job stage
      • Put on hold
      • Remove on hold
      • Mark as complete
      • Mark as uncompleted
      • Mark as free of charge
      • Mark as aborted
  • Users & Vehicles
    • Users
      • List users
  • Settings
    • List titles
      GET
    • List advertising types
      GET
    • List telephone types
      GET
    • List business units
      GET
    • List user groups
      GET
    • List provinces
      GET
  • Webhooks
    • Webhooks
    • Example PHP script
  1. Introduction

Rate-limits

To ensure high availability and fair usage for all our users, the Commusoft v2 API implements rate limiting.

Limits#

Our standard rate limit is 60 requests per minute per API Key. This is a rolling 60 second window. When a request is received, Commusoft determine whether there has been 60 or more requests in the last 60 seconds, if there has it will throw a 429.

Monitoring Your Usage#

Every response from our server (including error responses) contains specific headers that tell you exactly where you stand against your current quota. We recommend building your integration to proactively monitor these headers and throttle requests locally.
X-RateLimit-Limit
The total number of requests allowed in the current window.
X-RateLimit-Remaining
The number of requests you have left before being throttled.
X-RateLimit-Reset
The Unix timestamp indicating exactly when your quota will fully refresh.

Handling Throttling#

If you exceed the allowed limit, the API will return a 429 Too Many Requests status code.
When your application receives a 429 error, it should stop making requests until the time specified in the X-RateLimit-Reset header has passed. Continuing to make requests while throttled may result in longer wait times or temporary IP suspension.
Modified at 2026-06-16 12:24:34
Previous
Authentication
Next
Requests and responses
Built with