curl --request GET \
--url https://operator.opus.com/api/v1/discovery/process/{PROCESS_ID} \
--header 'x-service-key: {YOUR_SERVICE_KEY}'
import requests
process_id = "{PROCESS_ID}"
url = f"https://operator.opus.com/api/v1/discovery/process/{process_id}"
headers = {"x-service-key": "{YOUR_SERVICE_KEY}"}
response = requests.get(url, headers=headers)
print(response.json())
const processId = "{PROCESS_ID}";
const response = await fetch(
`https://operator.opus.com/api/v1/discovery/process/${processId}`,
{
method: "GET",
headers: { "x-service-key": "{YOUR_SERVICE_KEY}" },
}
);
const data = await response.json();
console.log(data);
{
"id": "{PROCESS_ID}",
"name": "Invoice Approval",
"description": "",
"status": "approved",
"organizationId": "{ORGANIZATION_ID}",
"workspaceId": "{WORKSPACE_ID}",
"stepCount": 8,
"branchCount": 2,
"processOrigin": null,
"parentProcessId": null,
"steps": [
{
"id": "{STEP_ID}",
"name": "Invoice Request Received",
"description": "A request or bill arrives from a supplier.",
"stepOrder": 1,
"stepType": "task",
"status": "approved",
"owner": "Accounts Payable",
"locked": true,
"duration": 15,
"durationUnit": "minutes",
"durationRange": null,
"waitingTimeRange": null,
"branchId": null,
"branchLabel": null,
"branchSourceStepId": null,
"branchRejoinStepId": null,
"branchOrder": 0,
"groupId": null,
"inputs": [{ "id": "{ITEM_ID}", "text": "Supplier invoice" }],
"outputs": [{ "id": "{ITEM_ID}", "text": "Logged invoice record" }],
"integrations": [{ "id": "{ITEM_ID}", "text": "Email" }],
"rules": [],
"departments": [{ "id": "{ITEM_ID}", "text": "Finance" }],
"performers": [{ "id": "{ITEM_ID}", "text": "AP Clerk" }],
"painPoints": [{ "id": "{ITEM_ID}", "text": "Invoices arrive in inconsistent formats" }]
}
],
"customEdges": [
{
"id": "{EDGE_ID}",
"sourceStepId": "{STEP_ID}",
"targetStepId": "{STEP_ID}",
"label": null
}
],
"processInputs": [],
"processOutputs": [],
"processIntegrations": [],
"processRules": [],
"milestone": { "country": "United Arab Emirates", "industry": "Financial Services" },
"createdAt": "2026-08-13T08:00:00.000Z",
"updatedAt": "2026-08-13T09:12:44.000Z"
}
Business Process Discovery
Get a Process
Retrieve a discovered process with its steps, edges and tagged items
GET
/
api
/
v1
/
discovery
/
process
/
{processId}
curl --request GET \
--url https://operator.opus.com/api/v1/discovery/process/{PROCESS_ID} \
--header 'x-service-key: {YOUR_SERVICE_KEY}'
import requests
process_id = "{PROCESS_ID}"
url = f"https://operator.opus.com/api/v1/discovery/process/{process_id}"
headers = {"x-service-key": "{YOUR_SERVICE_KEY}"}
response = requests.get(url, headers=headers)
print(response.json())
const processId = "{PROCESS_ID}";
const response = await fetch(
`https://operator.opus.com/api/v1/discovery/process/${processId}`,
{
method: "GET",
headers: { "x-service-key": "{YOUR_SERVICE_KEY}" },
}
);
const data = await response.json();
console.log(data);
{
"id": "{PROCESS_ID}",
"name": "Invoice Approval",
"description": "",
"status": "approved",
"organizationId": "{ORGANIZATION_ID}",
"workspaceId": "{WORKSPACE_ID}",
"stepCount": 8,
"branchCount": 2,
"processOrigin": null,
"parentProcessId": null,
"steps": [
{
"id": "{STEP_ID}",
"name": "Invoice Request Received",
"description": "A request or bill arrives from a supplier.",
"stepOrder": 1,
"stepType": "task",
"status": "approved",
"owner": "Accounts Payable",
"locked": true,
"duration": 15,
"durationUnit": "minutes",
"durationRange": null,
"waitingTimeRange": null,
"branchId": null,
"branchLabel": null,
"branchSourceStepId": null,
"branchRejoinStepId": null,
"branchOrder": 0,
"groupId": null,
"inputs": [{ "id": "{ITEM_ID}", "text": "Supplier invoice" }],
"outputs": [{ "id": "{ITEM_ID}", "text": "Logged invoice record" }],
"integrations": [{ "id": "{ITEM_ID}", "text": "Email" }],
"rules": [],
"departments": [{ "id": "{ITEM_ID}", "text": "Finance" }],
"performers": [{ "id": "{ITEM_ID}", "text": "AP Clerk" }],
"painPoints": [{ "id": "{ITEM_ID}", "text": "Invoices arrive in inconsistent formats" }]
}
],
"customEdges": [
{
"id": "{EDGE_ID}",
"sourceStepId": "{STEP_ID}",
"targetStepId": "{STEP_ID}",
"label": null
}
],
"processInputs": [],
"processOutputs": [],
"processIntegrations": [],
"processRules": [],
"milestone": { "country": "United Arab Emirates", "industry": "Financial Services" },
"createdAt": "2026-08-13T08:00:00.000Z",
"updatedAt": "2026-08-13T09:12:44.000Z"
}
Retrieve a discovered business process — its steps, the edges between them, and the inputs, outputs, systems and rules recorded against each step and against the process as a whole.
Requires the Discovery: Read permission in the workspace that owns the process.
Pass
processVersionId to read a saved snapshot instead of the current state. Both return the same shape.Headers
Path Parameters
Query Parameters
Response
The process steps. See Step object.
Edges connecting the steps. Each has
id, sourceStepId, targetStepId and an optional label.Step object
Each entry insteps carries the work itself plus everything tagged against it.
Active-duration range as
{ min, max }, each a { value, unit } bound. Null when the step only has the scalar duration.Errors
You do not have access to this process — it belongs to another organization, or the key’s user lacks the Discovery: Read permission in its workspace.
curl --request GET \
--url https://operator.opus.com/api/v1/discovery/process/{PROCESS_ID} \
--header 'x-service-key: {YOUR_SERVICE_KEY}'
import requests
process_id = "{PROCESS_ID}"
url = f"https://operator.opus.com/api/v1/discovery/process/{process_id}"
headers = {"x-service-key": "{YOUR_SERVICE_KEY}"}
response = requests.get(url, headers=headers)
print(response.json())
const processId = "{PROCESS_ID}";
const response = await fetch(
`https://operator.opus.com/api/v1/discovery/process/${processId}`,
{
method: "GET",
headers: { "x-service-key": "{YOUR_SERVICE_KEY}" },
}
);
const data = await response.json();
console.log(data);
{
"id": "{PROCESS_ID}",
"name": "Invoice Approval",
"description": "",
"status": "approved",
"organizationId": "{ORGANIZATION_ID}",
"workspaceId": "{WORKSPACE_ID}",
"stepCount": 8,
"branchCount": 2,
"processOrigin": null,
"parentProcessId": null,
"steps": [
{
"id": "{STEP_ID}",
"name": "Invoice Request Received",
"description": "A request or bill arrives from a supplier.",
"stepOrder": 1,
"stepType": "task",
"status": "approved",
"owner": "Accounts Payable",
"locked": true,
"duration": 15,
"durationUnit": "minutes",
"durationRange": null,
"waitingTimeRange": null,
"branchId": null,
"branchLabel": null,
"branchSourceStepId": null,
"branchRejoinStepId": null,
"branchOrder": 0,
"groupId": null,
"inputs": [{ "id": "{ITEM_ID}", "text": "Supplier invoice" }],
"outputs": [{ "id": "{ITEM_ID}", "text": "Logged invoice record" }],
"integrations": [{ "id": "{ITEM_ID}", "text": "Email" }],
"rules": [],
"departments": [{ "id": "{ITEM_ID}", "text": "Finance" }],
"performers": [{ "id": "{ITEM_ID}", "text": "AP Clerk" }],
"painPoints": [{ "id": "{ITEM_ID}", "text": "Invoices arrive in inconsistent formats" }]
}
],
"customEdges": [
{
"id": "{EDGE_ID}",
"sourceStepId": "{STEP_ID}",
"targetStepId": "{STEP_ID}",
"label": null
}
],
"processInputs": [],
"processOutputs": [],
"processIntegrations": [],
"processRules": [],
"milestone": { "country": "United Arab Emirates", "industry": "Financial Services" },
"createdAt": "2026-08-13T08:00:00.000Z",
"updatedAt": "2026-08-13T09:12:44.000Z"
}
Was this page helpful?