List runs | Plextera Public API

{
  "data": [
    {
      "id": "run_9f8b7c6d5e4a3b2c1d0e",
      "status": "FAILED",
      "createdAt": "2024-01-15T09:30:00Z",
      "updatedAt": "2024-01-15T09:45:00Z",
      "startedAt": "2024-01-15T09:31:00Z",
      "completedAt": "2024-01-15T09:44:59Z",
      "error": {
        "code": "DOCUMENT_REJECTED",
        "message": "The document was rejected due to missing required fields."
      },
      "workflow": {
        "id": "claims-loader",
        "name": "Claims Loader"
      },
      "progress": {
        "stepsCompleted": 3,
        "stepsTotal": 5
      },
      "durationMs": 840000,
      "computedDurationMs": 839000,
      "steps": [
        {
          "id": "step_01",
          "name": "Document Upload",
          "type": "document_insights",
          "status": "COMPLETED",
          "message": "Document uploaded successfully.",
          "output": {
            "documentId": "doc_1234567890",
            "pages": 10
          },
          "nestedRuns": {
            "count": 1,
            "data": [
              {
                "id": "run_nested_001",
                "status": "COMPLETED",
                "createdAt": "2024-01-15T09:31:30Z",
                "updatedAt": "2024-01-15T09:33:00Z",
                "startedAt": "2024-01-15T09:31:35Z",
                "completedAt": "2024-01-15T09:32:59Z",
                "error": null,
                "workflow": {
                  "id": "claims-validation",
                  "name": "Claims Validation"
                },
                "progress": {
                  "stepsCompleted": 4,
                  "stepsTotal": 4
                },
                "durationMs": 90000,
                "computedDurationMs": 85000,
                "steps": [
                  {
                    "id": "val_step_01",
                    "name": "Validate Fields",
                    "type": "web_function",
                    "status": "COMPLETED",
                    "message": "All required fields validated.",
                    "output": {
                      "valid": true
                    },
                    "nestedRuns": null
                  }
                ]
              }
            ]
          }
        }
      ]
    }
  ],
  "pageInfo": {
    "page": 0,
    "size": 1,
    "totalItems": 25,
    "totalPages": 25
  }
}

Returns recent workflow runs with status and progress, newest first. Use Get run for step-level output.

Authentication

Authorizationstring

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

Query parameters

pageintegerOptional1-100Defaults to 50

Zero-based page index. Defaults to 0.

sizeintegerOptional1-100Defaults to 50

Page size between 1 and 100. Defaults to 50.

statusenumOptional

Filter by run status. CLOSED finds runs closed in Plextera Studio.

Allowed values:

workflowIdstringOptional

Return runs of one workflow only.

Response

One page of workflow runs.

datalist of objects

Items on the requested page.

pageInfoobject

Paging details for this result set.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

405

Method Not Allowed Error

406

Not Acceptable Error

409

Conflict Error

500

Internal Server Error

502

Bad Gateway Error

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