The ProcessorRun object

The ProcessorRun object is the core object of processor runs, and is returned by the Run Processor endpoint as well as the Get Processor Run endpoint. These objects also represent a single output of a workflow run, which would typically have a list of multiple processor runs for chained processors.

The object represents a single run of a processor and contains all the information about the run, including the output data, the processor that was run, and the status of the run.

properties

object

string

The type of response, will always be “document_processor_run”.

string

The unique identifier for this processor run.

mergedProcessors

array

An array of processors that were merged to create this output. Will be an empty array unless this output was the result of a MergeExtraction step in a workflow.

properties

processorId

string

The ID of the merged processor.

processorVersionId

string

The ID of the specific processor version that was merged.

processorName

string

The name of the merged processor.

output

object

The final output, either reviewed or initial.

Conforms to the shape of output types and depends on the processor type and configuration shape.

processorId

string

The ID of the processor used for this run.

processorVersionId

string

The ID of the specific processor version used.

processorName

string

The name of the processor.

status

string

The current status of the processor run (e.g., “PROCESSING”, “PROCESSED”, “FAILED”).

failureReason

string

If the run failed, indicates the reason for failure.

failureMessage

string

If the run failed, provides a detailed message about the failure.

metadata

object

Any metadata that was provided when creating the processor run.

reviewed

boolean

Indicates whether the run has been reviewed.

edited

boolean

Indicates whether the run results have been edited.

edits

object

Contains any edits made to the processor output.

properties

fieldName

object

For each edited field:

originalValue

any

The original value before editing.

editedValue

any

The value after editing.

fieldType

string

The type of the field.

notes

string

Any notes added during editing.

type

string

The type of processor (e.g., “EXTRACT”, “CLASSIFY”).

config

object

The configuration used for this processor run.

initialOutput

object

The initial output from the processor.

reviewedOutput

object

The output after review, if any.

files

array

Details of the processed files.

If this was a file generated from a splitter processor, this will be the sub file.

See the File object for more details.

url

string

URL to view the processor run.

1	{
2	"object": "document_processor_run",
3	"id": "dpr_1234",
4	"output": { // Will be null until the run is processed
5	// Output object - see “Processor output types” for details
6	},
7	"processorId": "dp_5678",
8	"processorVersionId": "dpv_91011",
9	"processorName": "Invoice Extractor",
10	"status": "PROCESSED",
11	"metadata": {
12	"internal_id": "id_1234"
13	},
14	"reviewed": false,
15	"edited": false,
16	"edits": null,
17	"type": "EXTRACT",
18	"mergedProcessors": [],
19	"config": {
20	// Config object - see “Processor configs” for details
21	},
22	"files": [
23	{
24	"name": "example.pdf",
25	// Other file fields, which can be found in the File object page
26	}
27	],
28	"url": "https://dashboard.extend.app/runs/dpr_1234"
29	}

1	{
2	"object": "document_processor_run",
3	"id": "dpr_1234",
4	"output": { // Will be null until the run is processed
5	// Output object - see “Processor output types” for details
6	},
7	"processorId": "dp_5678",
8	"processorVersionId": "dpv_91011",
9	"processorName": "Invoice Extractor",
10	"status": "PROCESSED",
11	"metadata": {
12	"internal_id": "id_1234"
13	},
14	"reviewed": false,
15	"edited": false,
16	"edits": null,
17	"type": "EXTRACT",
18	"mergedProcessors": [],
19	"config": {
20	// Config object - see “Processor configs” for details
21	},
22	"files": [
23	{
24	"name": "example.pdf",
25	// Other file fields, which can be found in the File object page
26	}
27	],
28	"url": "https://dashboard.extend.app/runs/dpr_1234"
29	}