Get run | Plextera Public API

{
  "id": "69d224901610662a576cd7e6",
  "status": "COMPLETED",
  "createdAt": "2026-04-07T10:05:04Z",
  "updatedAt": "2026-04-07T10:07:31Z",
  "startedAt": "2026-04-07T10:05:05Z",
  "completedAt": "2026-04-07T10:07:31Z",
  "workflow": {
    "id": "invoice-processing",
    "name": "Invoice Processing"
  },
  "progress": {
    "stepsCompleted": 1,
    "stepsTotal": 1
  },
  "durationMs": 146000,
  "computedDurationMs": 142000,
  "steps": [
    {
      "id": "step_01",
      "name": "Extract Invoice",
      "type": "document_insights",
      "status": "COMPLETED",
      "output": {
        "document": {
          "fileName": "invoice.pdf",
          "id": "69d224901610662a576cd800",
          "mimeType": "APPLICATION_PDF",
          "size": 126,
          "source": "DOCUMENT_INSIGHTS"
        },
        "extractionId": "69654f0bc073ef404baec649",
        "fields": [
          {
            "id": "605c644cbf48241234f62121",
            "name": "vendorName",
            "type": "TEXT",
            "value": "Acme Industries Ltd"
          }
        ],
        "fileName": "invoice.pdf",
        "metaAttributes": {
          "recordId": "69654f0bc073ef404baec649"
        }
      },
      "nestedRuns": {
        "count": 0,
        "data": []
      }
    }
  ]
}

Returns one workflow run with step output. Terminal statuses are COMPLETED, FAILED, and CLOSED.

Authentication

Authorizationstring

Use the API key format: api-key <token>.

Path parameters

runIdstringRequired

Run identifier returned by Create run.

Response

Current run state with step-level output.

idstringOptional

Run identifier. Use it with GET /workflow-runs/{runId} and event correlation.

statusenumOptional

Current run state. Stop polling on COMPLETED, FAILED, or CLOSED.

createdAtdatetimeOptional

UTC timestamp when the run was accepted.

updatedAtdatetimeOptional

UTC timestamp of the latest known state change.

startedAtdatetimeOptional

UTC timestamp when execution started.

completedAtdatetimeOptional

UTC timestamp when the run reached a terminal state. Omitted while it is still processing.

errorobjectOptional

Failure details. Present only for failed runs.

workflowobjectOptional

The workflow this run belongs to.

progressobjectOptional

Step completion progress.

durationMslongOptional

Wall-clock duration from createdAt to completedAt in milliseconds. Omitted until the run is terminal.

computedDurationMslongOptional

Active processing time in milliseconds reported by Studio, excluding wait states and idle time in parallel branches. May be omitted from list summaries.

stepslist of objectsOptional

Executed steps with their public output.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

405

Method Not Allowed Error

406

Not Acceptable Error

409

Conflict Error

429

Too Many Requests Error

500

Internal Server Error

502

Bad Gateway Error

$	curl https://api.plextera.com/api/public/v1/workflow-runs/runId \
>	-H "Authorization: <apiKey>"