{"componentChunkName":"component---src-templates-simple-markdown-js","path":"/celonis-apis/data-job-execution-api/","matchPath":"","result":{"data":{"markdownRemark":{"html":"

Executing data jobs using a RESTful API

\n

Using RESTful APIs, you can both execute a data job and query the status of existing data jobs. For both requests you need the data pool ID (poolId) and data job ID (jobId). These can be retrieved from the URL of the respective data jobs using the example below:

\n
\n
\n
Copy
\n
Copied
\n
\n 
[https://[customerdomain].[realm].celonis.cloud/integration/ui/pools/{poolid}/data-configuration/data-jobs?jobId={jobid}](null)
\n
\n

Security

\n

The following bearer and AppKey security settings are available:

\n

Bearer

\n\n

AppKey

\n\n

Using an OAuth client

\n

If you're using an OAuth client, the following is needed:

\n\n

\n \n

Copy
\n
Copied
\n \n 
`import requests` \\\n \\\n`tenant = 'xyz' # the name of your team (your subdomain)` \\\n`realm = 'xyz' # e.g. eu-1, us-1, eu-2` \\\n`api_key = 'xyz' # the API key` \\\n`pool_id = 'xyz' # the Data Pool ID (see above)` \\\n`data_job_id = 'xyz' # the Data Job ID (see above)url = \"https://{}.{}.celonis.cloud/integration/api/v2/data-pools/{}/data-jobs/{}/execute?mode={}\".format(tenant, realm, pool_id, data_job_id, data_job_mode)` \\\n`data_job_mode = 'DELTA' # the mode of the Data Job (see above)` \\\n \\\n`url = \"https://{}.{}.celonis.cloud/integration/api/v2/data-pools/{}/data-jobs/{}/execute?mode={}\".format(tenant, realm, pool_id, data_job_id, data_job_mode)` \\\n \\\n`requests.post(url, headers={'authorization': \"Bearer {}\".format(api_key)})`
\n \n

Querying the status of a data job

\n

After executing a data job, you can query the status of that data job using the following RESTful API:

\n
\n
\n
Copy
\n
Copied
\n
\n 
GET /integration/api/pools/{poolId}/jobs/{jobId}
\n
","headings":[{"value":"Executing data jobs using a RESTful API","depth":1},{"value":"Security","depth":2},{"value":"Bearer","depth":3},{"value":"AppKey","depth":3},{"value":"Using an OAuth client","depth":2},{"value":"Executing data jobs","depth":2},{"value":"Querying the status of a data job","depth":2}]},"contentItem":{"data":{"lastModified":"2025-05-22T17:57:31.000Z","enableToc":null,"disableLastModified":null,"tocMaxDepth":null,"requestLogin":false}},"siteConfig":{"enableToc":false,"disableLastModified":false,"tocMaxDepth":4}},"pageContext":{"matchPath":"","id":"8032b2e7-1c1c-5fd5-a0ea-4679cbeb7525__redocly content/celonis-apis/data-job-execution-api/","seo":{"title":"Executing data jobs using a RESTful API","description":null,"image":"","keywords":null,"jsonLd":null,"lang":null,"siteUrl":null},"pageId":"celonis-apis/data-job-execution-api.md","pageBaseUrl":"/celonis-apis/data-job-execution-api","type":"markdown","toc":{"enable":true,"maxDepth":4,"headings":[{"depth":1,"value":"Executing data jobs using a RESTful API","id":"executing-data-jobs-using-a-restful-api"},{"depth":2,"value":"Security","id":"security"},{"depth":3,"value":"Bearer","id":"bearer"},{"depth":3,"value":"AppKey","id":"appkey"},{"depth":2,"value":"Using an OAuth client","id":"using-an-oauth-client"},{"depth":2,"value":"Executing data jobs","id":"executing-data-jobs"},{"depth":2,"value":"Querying the status of a data job","id":"querying-the-status-of-a-data-job"}]},"data":{"title":""},"catalogInfo":null,"link":"/celonis-apis/data-job-execution-api/","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"]}