Retrieves a job by id, according to the Job interface in the engine.

Method

GET /job/{id}

Parameters

Path Parameters

Name	Description
id	The id of the job to be retrieved.

Result

A JSON object corresponding to the Job interface in the engine. Its properties are as follows:

Name	Type	Description
id	String	The id of the job.
jobDefinitionId	String	The id of the associated job definition.
dueDate	String	The date on which this job is supposed to be processed.
processInstanceId	String	The id of the process instance which execution created the job.
executionId	String	The specific execution id on which the job was created.
processDefinitionId	String	The id of the process definition which this job belongs to.
processDefinitionKey	String	The key of the process definition which this job belongs to.
retries	Number	The number of retries this job has left.
exceptionMessage	String	The message of the exception that occurred, the last time the job was executed. Is null when no exception occurred.
failedActivityId	String	The id of the activity on which the last exception occurred, the last time the job was executed. Is null when no exception occurred.
suspended	Boolean	A flag indicating whether the job is suspended or not.
priority	Number	The job's priority for execution.
tenantId	String	The id of the tenant which this job belongs to.
createTime	String	The date on which this job has been created.

Response Codes

Code	Media type	Description
200	application/json	Request successful.
404	application/json	Job with given id does not exist. See the Introduction for the error response format.

Example

Request

GET /job/aJobId

Response

{
  "id": "aJobId",
  "jobDefinitionId": "f9eec330-e3ff-11e8-8f7d-e4a7a094a9d6",
  "dueDate": "2018-07-17T17:00:00+0200",
  "processInstanceId": "aProcessInstanceId",
  "processDefinitionId": "timer:1:f9ee9c1f-e3ff-11e8-8f7d-e4a7a094a9d6",
  "processDefinitionKey": "timer",
  "executionId": "anExecutionId",
  "retries": 0,
  "exceptionMessage": "An exception Message",
  "failedActivityId": "anActivityId",
  "suspended": false,
  "priority": 10,
  "tenantId": null,
  "createTime": "2018-05-05T17:00:00+0200"
}