Retrieves a report about the duration of completed process instances, grouped by a period. These reports include the maximum, minimum and average duration of all completed process instances which were started in a given period.

Note: This only includes historic data.

Method

GET /history/process-instance/report?reportType=duration

Parameters

Query Parameters

Name	Description
reportType	Mandatory. Specifies the type of the report to retrieve. To retrieve a report about the duration of process instances, the value must be set to duration.
periodUnit	Mandatory. Specifies the granularity of the report. Valid values are month and quarter.
processDefinitionIdIn	Filter by process definition ids. Must be a comma-separated list of process definition ids.
processDefinitionKeyIn	Filter by process definition keys. Must be a comma-separated list of process definition keys.
startedBefore	Restrict to instances that were started before the given date. By default*, the date must have the format yyyy-MM-dd'T'HH:mm:ss.SSSZ, e.g., 2016-01-23T14:42:45.000+0200.
startedAfter	Restrict to instances that were started after the given date. By default*, the date must have the format yyyy-MM-dd'T'HH:mm:ss.SSSZ, e.g., 2016-01-23T14:42:45.000+0200.

* For further information, please see the documentation.

Result

A JSON array of duration report result objects. Each object has the following properties:

Name	Type	Description
period	Number	Specifies a timespan within a year. Note: The period must be interpreted in conjunction with the returned periodUnit.
periodUnit	String	The unit of the given period. Possible values are MONTH and QUARTER.
maximum	Number	The greatest duration in milliseconds of all completed process instances which were started in the given period.
minimum	Number	The smallest duration in milliseconds of all completed process instances which were started in the given period.
average	Number	The average duration in milliseconds of all completed process instances which were started in the given period.

Response Codes

Code	Media type	Description
200	application/json	Request successful.
200	application/csv or text/csv	Request successful. In case of an expected application/csv or text/csv response to retrieve the result as a csv file.
400	application/json	Returned if some of the query parameters are invalid or mandatory parameters are not supplied. See the Introduction for the error response format.
403	application/json	If the authenticated user is unauthorized to read the history. See the Introduction for the error response format.

Example

Request

GET /history/process-instance/report?reportType=duration&periodUnit=quarter&processDefinitionKeyIn=invoice

Response

[
  {
    "period": 1,
    "periodUnit": "QUARTER",
    "maximum": 500000,
    "minimum": 250000,
    "average": 375000
  },
  {
    "period": 2,
    "periodUnit": "QUARTER",
    "maximum": 600000,
    "minimum": 300000,
    "average": 450000
  },
  {
    "period": 3,
    "periodUnit": "QUARTER",
    "maximum": 1000000,
    "minimum": 500000,
    "average": 750000
  },
  {
    "period": 4,
    "periodUnit": "QUARTER",
    "maximum": 200000,
    "minimum": 100000,
    "average": 150000
  }
]