{"componentChunkName":"component---src-templates-simple-markdown-js","path":"/celonis-apis/get-started-with-celonis-apis/","matchPath":"","result":{"data":{"markdownRemark":{"html":"<h1 style=\"position:relative;\"><a href=\"#get-started-with-celonis-apis\" aria-label=\"get started with celonis apis permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"get-started-with-celonis-apis\"></div>Get started with Celonis APIs</h1>\n<p>Every Celonis customer has access to a range of APIs that provide access to ingest data into Celonis, consume process intelligence from Celonis, and administer the Celonis team.</p>\n<h2 style=\"position:relative;\"><a href=\"#reading-this-documentation\" aria-label=\"reading this documentation permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"reading-this-documentation\"></div>Reading this documentation</h2>\n<p>Each API endpoint in this documentation is described using several parts:</p>\n<ul>\n<li>\n<strong>The HTTP method.</strong>\n  Includes  \n<code class=\"language-text\">GET</code>\n,  \n<code class=\"language-text\">POST</code>\n,  \n<code class=\"language-text\">PUT</code>\n,  \n<code class=\"language-text\">PATCH</code>\n,  and \n<code class=\"language-text\">DELETE</code>\n.\n</li>\n<li>\n<strong>The base path.</strong>\n  All URLs referenced in the documentation have the base path \n<code class=\"language-text\">https://{team_domain}.{realm}.celonis.cloud</code>\n. This base path goes \n<em>before</em>\n the endpoint path.\n</li>\n<li>\n<strong>The endpoint path.</strong>\n  The endpoint path is resource-oriented. For example, \n<code class=\"language-text\">/intelligence/api/knowledge-models/{km-id}/records/{record-id}</code>\n.\n</li>\n<li>\n<strong>Required parameters.</strong>\n  These parameters must be included in a request. In the example above,  \n<code class=\"language-text\">{km-id}</code>\n  and  \n<code class=\"language-text\">{record-id}</code>\n  are required parameters representing the resources to be accessed. In a request, you will replace the placeholders with real values. \n</li>\n<li>\n<strong>Optional parameters.</strong>\n  These parameters can be included in a request to customize the query. Query parameters are added to the end of the URL with  \n<a href=\"https://en.wikipedia.org/wiki/Query_string\">query string encoding</a>\n.\n</li>\n<li>\n<strong>A token scope.</strong>\n  If an API endpoint requires a \n<a href=\"/celonis-apis/auth/#authorization\">token scope</a>\n that the default access token does not have, the token scope will be listed instead.\n</li>\n<li>\n<strong>Code examples.</strong>\n  Each endpoint has example requests in \n<a href=\"http://curl.haxx.se/\">cURL</a>\n format and in the following programming languages: \n<a href=\"https://www.w3schools.com/js/default.asp\">JavaScript</a>\n, \n<a href=\"https://www.w3schools.com/java/default.asp\">Java</a>\n, \n<a href=\"https://www.w3schools.com/python/default.asp\">Python</a>\n, and \n<a href=\"https://www.w3schools.com/php/default.asp\">PHP</a>\n.\n</li>\n<li>\n<strong>API Essentials.</strong>\n Features applicable to all APIs such as Authentication/Authorization, Pagination, Quotas and Rate limiting, and Error Message Standardization are handled in the \n<a href=\"/celonis-apis/get-started-with-celonis-apis/#api-essentials\">API Essentials</a>\n section below.\n</li>\n</ul>\n<h2 style=\"position:relative;\"><a href=\"#api-essentials\" aria-label=\"api essentials permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"api-essentials\"></div>API Essentials</h2>\n<h3 style=\"position:relative;\"><a href=\"#install-a-rest-client\" aria-label=\"install a rest client permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"install-a-rest-client\"></div><a href=\"/celonis-apis/rest-client/\">Install a REST Client</a></h3>\n<p>How to <a href=\"/celonis-apis/rest-client/\">install a REST client</a> to access Celonis APIs.</p>\n<h3 style=\"position:relative;\"><a href=\"#authenticationauthorization\" aria-label=\"authenticationauthorization permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"authenticationauthorization\"></div><a href=\"/celonis-apis/auth/\">Authentication/Authorization</a></h3>\n<p>The user security and permissions <a href=\"/celonis-apis/auth/\">framework</a> to access Celonis platform via Celonis APIs.</p>\n<h3 style=\"position:relative;\"><a href=\"#result-pagination\" aria-label=\"result pagination permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"result-pagination\"></div><a href=\"/celonis-apis/pagination/\">Result Pagination</a></h3>\n<p>When you call a Celonis API method to retrieve a collection of objects, they are usually returned in portions. Check out the details on <a href=\"/celonis-apis/pagination/\">pagination in API methods</a>, including how to use them and which methods follow the pattern.</p>\n<h3 style=\"position:relative;\"><a href=\"#quotas-and-rate-limiting\" aria-label=\"quotas and rate limiting permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"quotas-and-rate-limiting\"></div><a href=\"/celonis-apis/rate-limiting/\">Quotas and Rate Limiting</a></h3>\n<p>Celonis Platform features and APIs rely on rate limits to help provide a predictable experience for users. The details of how and when rate limiting works differs between API families and features. This <a href=\"/celonis-apis/rate-limiting/\">article</a> gives an overview of the rate limits you're likely to encounter for Celonis API families and notes how the limits apply to each family.</p>\n<h3 style=\"position:relative;\"><a href=\"#common-error-messages\" aria-label=\"common error messages permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"common-error-messages\"></div><a href=\"/celonis-apis/api-reference/common-error-catalog/\">Common Error Messages</a></h3>\n<p>This article identifies some of the error codes and messages that Celonis APIs return. Specifically, <a href=\"/celonis-apis/api-reference/common-error-catalog/\">the errors listed here</a> are in the global, or default, domain for Celonis APIs. Many APIs also define their own domains, which identify API-specific errors that are not in the global domain. </p>","headings":[{"value":"Get started with Celonis APIs","depth":1},{"value":"Reading this documentation","depth":2},{"value":"API Essentials","depth":2},{"value":"Install a REST Client","depth":3},{"value":"Authentication/Authorization","depth":3},{"value":"Result Pagination","depth":3},{"value":"Quotas and Rate Limiting","depth":3},{"value":"Common Error Messages","depth":3}]},"contentItem":{"data":{"lastModified":"2025-08-13T20:04:37.000Z","enableToc":null,"disableLastModified":null,"tocMaxDepth":null,"requestLogin":false}},"siteConfig":{"enableToc":false,"disableLastModified":false,"tocMaxDepth":4}},"pageContext":{"matchPath":"","id":"f6b35c31-6392-5eb2-a3c7-c93fc5f9ef9d__redocly content/celonis-apis/get-started-with-celonis-apis/","seo":{"title":"Get started with Celonis APIs","description":null,"image":"","keywords":null,"jsonLd":null,"lang":null,"siteUrl":null},"pageId":"celonis-apis/get-started-with-celonis-apis.md","pageBaseUrl":"/celonis-apis/get-started-with-celonis-apis","type":"markdown","toc":{"enable":true,"maxDepth":4,"headings":[{"depth":1,"value":"Get started with Celonis APIs","id":"get-started-with-celonis-apis"},{"depth":2,"value":"Reading this documentation","id":"reading-this-documentation"},{"depth":2,"value":"API Essentials","id":"api-essentials"},{"depth":3,"value":"Install a REST Client","id":"install-a-rest-client"},{"depth":3,"value":"Authentication/Authorization","id":"authenticationauthorization"},{"depth":3,"value":"Result Pagination","id":"result-pagination"},{"depth":3,"value":"Quotas and Rate Limiting","id":"quotas-and-rate-limiting"},{"depth":3,"value":"Common Error Messages","id":"common-error-messages"}]},"data":{"title":""},"catalogInfo":null,"link":"/celonis-apis/get-started-with-celonis-apis/","sidebarName":"celonis","isLanding":false,"showPrevButton":null,"showNextButton":null,"apiVersions":null,"apiVersionId":null,"isDefaultApiVersion":null}},"staticQueryHashes":["1123603147","1302185487","1344209882","1398840060","1520077861","1975142765","2667623876","2950305614","3240152602","3743992808","561138138"]}