Get process instance

GET 
/process-instances/:processInstanceKey

Get the process instance by the process instance key.

Request

Path Parameters

processInstanceKey int64required

The process instance key.

Responses

200

The process instance is successfully returned.

application/json

Schema

Schema

processDefinitionId string

The process definition ID.

processDefinitionName string

The process definition name.

processDefinitionVersion int32

The process definition version.

processDefinitionVersionTag string

The process definition version tag.

startDate date-time

The start date.

endDate date-time

The end date.

state ProcessInstanceStateEnum

Possible values: [ACTIVE, COMPLETED, CANCELED]

The state, one of ACTIVE, COMPLETED, CANCELED.

hasIncident boolean

Whether this process instance has a related incident or not.

tenantId string

The tenant ID.

processInstanceKey string

The key of this process instance.

processDefinitionKey string

The process definition key.

parentProcessInstanceKey string

The parent process instance key.

parentFlowNodeInstanceKey string

The parent flow node instance key.

Example (from schema)

{
  "processInstanceKey": "string",
  "processDefinitionKey": "string",
  "parentProcessInstanceKey": "string",
  "parentFlowNodeInstanceKey": "string",
  "processDefinitionId": "string",
  "processDefinitionName": "string",
  "processDefinitionVersion": 0,
  "processDefinitionVersionTag": "string",
  "startDate": "2024-12-19T15:07:40.116Z",
  "endDate": "2024-12-19T15:07:40.116Z",
  "hasIncident": true,
  "tenantId": "string"
}

application/vnd.camunda.api.keys.number+json

Schema

Schema

processDefinitionId string

The process definition ID.

processDefinitionName string

The process definition name.

processDefinitionVersion int32

The process definition version.

processDefinitionVersionTag string

The process definition version tag.

startDate date-time

The start date.

endDate date-time

The end date.

state ProcessInstanceStateEnum

Possible values: [ACTIVE, COMPLETED, CANCELED]

The state, one of ACTIVE, COMPLETED, CANCELED.

hasIncident boolean

Whether this process instance has a related incident or not.

tenantId string

The tenant ID.

processInstanceKey int64

The key of this process instance.

processDefinitionKey int64

The process definition key.

parentProcessInstanceKey int64

The parent process instance key.

parentFlowNodeInstanceKey int64

The parent flow node instance key.

Example (from schema)

{
  "processInstanceKey": 0,
  "processDefinitionKey": 0,
  "parentProcessInstanceKey": 0,
  "parentFlowNodeInstanceKey": 0,
  "processDefinitionId": "string",
  "processDefinitionName": "string",
  "processDefinitionVersion": 0,
  "processDefinitionVersionTag": "string",
  "startDate": "2024-12-19T15:07:40.116Z",
  "endDate": "2024-12-19T15:07:40.116Z",
  "hasIncident": true,
  "tenantId": "string"
}

application/vnd.camunda.api.keys.string+json

Schema

Schema

processDefinitionId string

The process definition ID.

processDefinitionName string

The process definition name.

processDefinitionVersion int32

The process definition version.

processDefinitionVersionTag string

The process definition version tag.

startDate date-time

The start date.

endDate date-time

The end date.

state ProcessInstanceStateEnum

Possible values: [ACTIVE, COMPLETED, CANCELED]

The state, one of ACTIVE, COMPLETED, CANCELED.

hasIncident boolean

Whether this process instance has a related incident or not.

tenantId string

The tenant ID.

processInstanceKey string

The key of this process instance.

processDefinitionKey string

The process definition key.

parentProcessInstanceKey string

The parent process instance key.

parentFlowNodeInstanceKey string

The parent flow node instance key.

Example (from schema)

{
  "processInstanceKey": "string",
  "processDefinitionKey": "string",
  "parentProcessInstanceKey": "string",
  "parentFlowNodeInstanceKey": "string",
  "processDefinitionId": "string",
  "processDefinitionName": "string",
  "processDefinitionVersion": 0,
  "processDefinitionVersionTag": "string",
  "startDate": "2024-12-19T15:07:40.117Z",
  "endDate": "2024-12-19T15:07:40.117Z",
  "hasIncident": true,
  "tenantId": "string"
}

400

The provided data is not valid.

application/problem+json

Schema

Schema

type uri

Default value: about:blank

A URI identifying the problem type.

title string

A summary of the problem type.

status int32

Possible values: >= 400 and <= 600

The HTTP status code for this problem.

detail string

An explanation of the problem in more detail.

instance uri

A URI identifying the origin of the problem.

Example (from schema)

{
  "type": "about:blank",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string"
}

401

The request lacks valid authentication credentials.

application/problem+json

Schema

Schema

type uri

Default value: about:blank

A URI identifying the problem type.

title string

A summary of the problem type.

status int32

Possible values: >= 400 and <= 600

The HTTP status code for this problem.

detail string

An explanation of the problem in more detail.

instance uri

A URI identifying the origin of the problem.

Example (from schema)

{
  "type": "about:blank",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string"
}

403

Forbidden. The request is not allowed.

application/problem+json

Schema

Schema

type uri

Default value: about:blank

A URI identifying the problem type.

title string

A summary of the problem type.

status int32

Possible values: >= 400 and <= 600

The HTTP status code for this problem.

detail string

An explanation of the problem in more detail.

instance uri

A URI identifying the origin of the problem.

Example (from schema)

{
  "type": "about:blank",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string"
}

404

The process instance with the given key was not found.

application/problem+json

Schema

Schema

type uri

Default value: about:blank

A URI identifying the problem type.

title string

A summary of the problem type.

status int32

Possible values: >= 400 and <= 600

The HTTP status code for this problem.

detail string

An explanation of the problem in more detail.

instance uri

A URI identifying the origin of the problem.

Example (from schema)

{
  "type": "about:blank",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string"
}

500

An internal error occurred while processing the request.

application/problem+json

Schema

Schema

type uri

Default value: about:blank

A URI identifying the problem type.

title string

A summary of the problem type.

status int32

Possible values: >= 400 and <= 600

The HTTP status code for this problem.

detail string

An explanation of the problem in more detail.

instance uri

A URI identifying the origin of the problem.

Example (from schema)

{
  "type": "about:blank",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string"
}

Loading...