{"componentChunkName":"component---src-templates-simple-markdown-js","path":"/process-intelligence-apis/knowledge-model-api/get-started/rate-limiting/","matchPath":"","result":{"data":{"markdownRemark":{"html":"

Rate limiting

\n

The Knowledge Model API was not built to export RAW data on a large scale but to make the calculated results and insights\nfrom process mining available to 3rd party platforms and applications. That’s why the Celonis API enforces rate\nlimiting. This means that only a certain number of requests are allowed per day and a specific number of records can be\nretrieved in each call. Celonis reserves the right to adjust the rate limits at any time to guarantee high-quality\nservice for all clients.

\n

If a client repeatedly exceeds the rate limits or engages in behavior that is deemed to be suspicious, Celonis\nreserves the right to temporarily or permanently limit or suspend access to the API for that client.

\n

When a client exceeds the number of requests per day, the Celonis API will return a 429 response (too many requests)\nincluding an HTTP header (x-ratelimit-reset) which indicates the time (in seconds) that the client needs to wait\nbefore a new request can be processed.

\n

The following HTTP headers are also returned as part of each call:

\n\n

Currently, the API has the following default limits:

\n

Table 1. Default rate limits

\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n
Limit\n Default Values\n
Max number of requests/day\n 6000 requests/day\n
Max number of requests/second\n 20 requests/second\n
Max number of allowed fields per request in the Celonis Platform Knowledge Model\n 200 fields/request\n
Total maximum number of records that can be retrieved through the /data endpoint.\n First 5000 records per filtered/sorted table\n
\n

Details about the license limits included in the contracts can be found in Terms and Conditions.

","headings":[{"value":"Rate limiting","depth":1}]},"contentItem":{"data":{"lastModified":"2025-10-07T16:52:38.000Z","enableToc":null,"disableLastModified":null,"tocMaxDepth":null,"requestLogin":false}},"siteConfig":{"enableToc":false,"disableLastModified":false,"tocMaxDepth":4}},"pageContext":{"matchPath":"","id":"0ebadfef-fb08-59ee-bac6-a1f73c16a20f__redocly content/process-intelligence-apis/knowledge-model-api/get-started/rate-limiting/","seo":{"title":"Rate limiting","description":null,"image":"","keywords":null,"jsonLd":null,"lang":null,"siteUrl":null},"pageId":"process-intelligence-apis/knowledge-model-api/get-started/rate-limiting.md","pageBaseUrl":"/process-intelligence-apis/knowledge-model-api/get-started/rate-limiting","type":"markdown","toc":{"enable":true,"maxDepth":4,"headings":[{"depth":1,"value":"Rate limiting","id":"rate-limiting"}]},"data":{"title":""},"catalogInfo":null,"link":"/process-intelligence-apis/knowledge-model-api/get-started/rate-limiting/","sidebarName":"","isLanding":false,"showPrevButton":null,"showNextButton":null,"apiVersions":null,"apiVersionId":null,"isDefaultApiVersion":null}},"staticQueryHashes":["1123603147","1302185487","1344209882","1398840060","1520077861","1975142765","2667623876","2950305614","3240152602","3743992808","561138138"]}