# API rate limits

> To ensure quality service and prevent abuse, Kustomer limits the number of API requests that can be made within a short period.

Source: https://help.kustomer.com/en_us/api-rate-limits-Sk2xoQgYX

Last updated: 2026-04-30T15:18:12.753Z

To ensure quality service and prevent abuse, Kustomer limits the number of API requests that can be made within a short period. API rate limits differ by [pricing tier](https://www.kustomer.com/pricing/). In the response header of most APIs, your current rate limit (x-ratelimit-limit) and remaining calls (x-ratelimit-remaining) will show. You can also see your rate limit and usage in the Kustomer platform. 

**Who can access this feature?**

**User types**

Admins can access the Platform Usage page.

  

### In this article:

*   [View API usage and rate limits](#view)
*   [Rate limit details](#details)

### View API usage and rate limit

You can track your API call usage in the Kustomer platform by going to **Settings**![](https://cdn.kustomerhostedcontent.com/media/570fad9d9001bc1000163b28/eacfde0b609be8cc92f10697c04d831a.png)\> **Platform** > **Platform Usage** and selecting the **Rate Usage** tab.

You can view API usage in ranges of 30 minutes, 60 minutes, 24 hours, or 7 days. Or, by clicking in the date field next to the calendar icon, you can input a custom range to view. The toggle to the right allows you to view usage by API key or by endpoint. 

The dropdown on the right within the chart allows you to adjust the y-axis of the chart to break down data anywhere from minutes to weekly. 

The red line on the chart indicates your rate limit. If your organization has lower API usage, click the Rate Limit key at the bottom left of the chart to zoom in.  ![](https://cdn.kustomerhostedcontent.com/media/570fad9d9001bc1000163b28/7c9dac786ef9fe309dcf6fb804c9fbff.png)

The API rate limit applies to all API tokens configured for your organization. The default rate limit interval is 60 seconds.

### Rate limit details

Visit the [pricing page](https://www.kustomer.com/usage-based-pricing/) to view the rate limits for your plan.

**Standard API limits**

*   This limit is counted against the sum of requests through the API across the entire platform, regardless of the endpoint or target object.
*   This limit is for API keys such as backend integrations and includes requests that pass through the API like bulk requests, paginated requests, and agent actions.
*   This limit _does not apply_ to workflows and business rules, which do not pass through the API.
*   Non-machine (human) users using the app have a limit of 1,000 rpm.
*   Data services like [Kinesis](https://help.kustomer.com/en_us/real-time-events-data-stream-rJhIYV2fM) do not count toward your API rate limit.

**Searches**

*   Machine users have an independent rate limit of 100 rpm, unless otherwise stated in your order.
*   Non-machine (human) users using a search in the app do not have a rate limit.

**Webhooks / form hooks**

*   Webhooks and form hooks have an independent rate limit of 1,000 rpm for Enterprise and 2,000 for Ultimate.
*   Webhooks have a body size limit of 400kb, including whitespace.

**Standard integrations**

*   Standard integrations that we offer for inbound/outbound message processing (such as Postmark for email, Twilio for SMS, or Facebook Messenger) are not rate-limited by organization.
*   However, some of these integrations _are_ limited in other ways. For example, Postmark limits the number of inbound emails from the same email address to 20 per hour to prevent an auto-reply loop.

**Object-specific rate limits**

*   Any conversation, company, or message object record can be updated 100 times in 10 minutes. This also applies to internal updates to a single customer record, such as those made via workflow.
    *   Customer via API is the only exception to this rule. A single customer can be updated via the API 600 times in 10 minutes.
*   A single request has the potential to incur a count against _both_ the standard API limit _and_ object-specific rate limit thresholds, such as an API request to update an object.

**WhatsApp outbound messages**

*   WhatsApp outbound messages are limited to 300 messages per minute per user. This limit applies to both machine and non-machine (human) users.

**Workflow executions**

*   Workflow executions are limited to 1,000 requests per 30 seconds per event type (for example, Conversation update). This prevents infinite looping workflows.

Learn more about rate limiting and using our API in the [Kustomer Developer Portal](https://developer.kustomer.com/kustomer-api-docs/reference/rate-limiting).

### ****Search API Data Retention and Pagination Limits****

****Data retention for the Search API:**** The standard Search API endpoint only returns records updated within the past 2 years. Conversations older than 2 years will not appear in search results.

****Retrieving older data with Archive Search:**** Use the Archive Search endpoint (`/v1/customers/archive/search`) to access conversations older than 2 years. This endpoint returns all records matching your query regardless of when they were last updated. It is not restricted to only old data.

****Pagination limits:**** There is a maximum of 100 pages per search query. If your result set exceeds 100 pages, use cursor-based pagination by querying based on the `updated_at` attribute and using the last `updated_at` value from your response as the starting point for your next query.
