{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Getting started","description":"API documentation for Celonis APIs.","siteUrl":"https://developer.celonis.com/","keywords":"celonis developer portal, celonis apis, celonis api reference docs","lang":"en-US","llmstxt":{"hide":false,"description":"Celonis API documentation","sections":[{"title":"API Docs","description":"Available Celonis API Docs","includeFiles":["**/*.md"],"excludeFiles":[]},{"title":"API Specs","description":"All Celonis API specifications","includeFiles":["**/openapi.yaml"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"getting-started","__idx":0},"children":["Getting started"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Reporting API supports industry standard REST requests to retrieve data. Please choose “REST API” in your 3rd party analytical tool to start the setup."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The location of the API resource is defined by the domains specified in the tables below and the endpoints as specified by the OpenAPI documentation. For example, to get your first 100 processes using the API as a US customer, you would make an API call similar to this, with the request headers as defined in the Authentication section below:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"GET [https://api-reporting.us-1.symbio.cloud/api/v1/elements?take=100\\&facetName=processes](https://api-reporting.us-1.symbio.cloud/api/v1/elements?take=100&facetName=processes)\n\n"},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Important"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The API will update data once a day overnight, so you will not see the latest data immediately after connection."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The API key will have an automatic 90 day expiration period, which requires a new API key to be generated in the Admin App. Without an updated API key, API calls on the receiving 3rd-party application will fail with “unauthorized” error."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prerequisites","__idx":1},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["An Admin App needs to be available on the database and model data needs to be created in the Designer in order for this feature to work."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"authentication","__idx":2},"children":["Authentication"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The API call can be authenticated with an API Key authentication method, and API keys can be generated via the Admin App. To request data, you need to specify both this key and that your tenant is within the REST API call."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":""},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Header"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":""},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Description"]}]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["x-tenant-id"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["This is a unique ID to identify your data location. Currently it can only be found by opening either the Navigator or Admin App and checking the URL of the page after it has fully loaded. You can find it via:",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"the first GUID of the Navigator URL: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://admin.symbio.cloud/?company=celonis&tenant=c592ade4-4a5a-4804-a6e0-267f6a164fc6"},"children":["https://navigator.symbio.cloud/celonis/",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["c592ade4-4a5a-4804-a6e0-267f6a164fc6"]}]}," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"or",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"the “tenant” section of the Admin App URL: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://admin.symbio.cloud/?company=celonis&tenant=c592ade4-4a5a-4804-a6e0-267f6a164fc6"},"children":["https://admin.symbio.cloud/?company=celonis&tenant=",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["c592ade4-4a5a-4804-a6e0-267f6a164fc6"]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["x-api-key"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The API key can be generated using the Admin App within the “Reporting” section."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"before-you-begin","__idx":3},"children":["Before you begin"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"using-a-template","__idx":4},"children":["Using a template"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the available template to jumpstart your configuration by downloading it ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/assets/template_for_reporting_api_extractor.861cd1e2178c3e7b6e504ba92cbc162d3cff603b5c40408251f3d7ffa0a5f1d6.e31bf237.json","title":"Template","download":""},"children":["here"]},". Within this template, you will find:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Predefined variables"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Endpoint configuration for \"elements\", \"facets\", and an example \"hierarchy\" for the Processes facet."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["More details on how to use this template can be found in the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/cpm/reporting/configure"},"children":["Configure"]}," section."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"pagination-considerations","__idx":5},"children":["Pagination considerations"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Maximum 100 elements per pagination. A custom pagination can be indicated with “take” & “Skip” operation. If not specified, the default max (100 elements) will be applied."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"versioning","__idx":6},"children":["Versioning"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The API is currently at version [1] with path v1. Future versions will be introduced with URL path versioning."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"data-formats","__idx":7},"children":["Data Formats"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The API uses JSON for request and response bodies."]}]},"headings":[{"value":"Getting started","id":"getting-started","depth":1},{"value":"Prerequisites","id":"prerequisites","depth":2},{"value":"Authentication","id":"authentication","depth":3},{"value":"Before you begin","id":"before-you-begin","depth":2},{"value":"Using a template","id":"using-a-template","depth":3},{"value":"Pagination considerations","id":"pagination-considerations","depth":3},{"value":"Versioning","id":"versioning","depth":3},{"value":"Data Formats","id":"data-formats","depth":3}],"frontmatter":{"seo":{"title":"Getting started"}},"lastModified":"2026-04-14T22:25:07.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/cpm/reporting/getting-started","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}