Get Execution Count
Queries for the number of executions that fulfill given parameters. Takes the same parameters as the Get Executions method.
Method
GET /execution/count
Parameters
Query Parameters
Name | Description |
---|---|
businessKey | Filter by the business key of the process instances the executions belong to. |
processDefinitionId | Filter by the process definition the executions run on. |
processDefinitionKey | Filter by the key of the process definition the executions run on. |
processInstanceId | Filter by the id of the process instance the execution belongs to. |
activityId | Filter by the id of the activity the execution currently executes. |
signalEventSubscriptionName | Select only those executions that expect a signal of the given name. |
messageEventSubscriptionName | Select only those executions that expect a message of the given name. |
active | Only include active executions. Value may only be true , as false is the default behavior. |
suspended | Only include suspended executions. Value may only be true , as false is the default behavior. |
incidentId | Filter by the incident id. |
incidentType | Filter by the incident type. See the User Guide for a list of incident types. |
incidentMessage | Filter by the incident message. Exact match. |
incidentMessageLike | Filter by the incident message that the parameter is a substring of. |
tenantIdIn | Filter by a comma-separated list of tenant ids. An execution must have one of the given tenant ids. |
variables | Only include executions that have variables with certain values.
Variable filtering expressions are comma-separated and are structured as follows: A valid parameter value has the form key_operator_value .
key is the variable name, operator is the comparison operator to be used and value the variable value.Note: Values are always treated as String objects on server side.Valid operator values are: eq - equal to; neq - not equal to; gt - greater than;
gteq - greater than or equal to; lt - lower than; lteq - lower than or equal to;
like .key and value may not contain underscore or comma characters.
|
processVariables | Only include executions that belong to a process instance with variables with certain values.
Variable filtering expressions are comma-separated and are structured as follows: A valid parameter value has the form key_operator_value .
key is the variable name, operator is the comparison operator to be used and value the variable value.Note: Values are always treated as String objects on server side.Valid operator values are: eq - equal to; neq - not equal to.key and value may not contain underscore or comma characters.
|
Result
A JSON object that contains the count as the only property.
Name | Value | Description |
---|---|---|
count | Number | The number of matching executions. |
Response Codes
Code | Media type | Description |
---|---|---|
200 | application/json | Request successful. |
400 | application/json | Returned if some of the query parameters are invalid, for example if a sortOrder parameter is supplied, but no sortBy , or if an invalid operator for variable comparison is used. See the Introduction for the error response format. |
Example
Request
GET /execution/count?variables=myVariable_eq_camunda
Response
{"count": 1}