> This page is for version v2024-12-23.
> For other versions, use one of these documentation indexes:
> - v2026-02-09 (default): https://docs.extend.ai/2026-02-09/llms.txt
> - v2025-04-21: https://docs.extend.ai/2025-04-21/llms.txt
> - v2024-12-23: https://docs.extend.ai/2024-12-23/llms.txt

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.extend.ai/llms.txt
> Use this file to discover all available pages before exploring further.
>
> ## API version
> The current API version is `2026-02-09`, served at the site root (no version prefix in URLs).
> If this page URL contains `/2025-04-21/` or `/2024-12-23/`, you are reading an older API version.
> Prefer the current docs at https://docs.extend.ai/llms.txt unless the user explicitly needs that older version.
> Do not treat older-version pages as the source of truth for new integrations.

# The ProcessorRun object

The ProcessorRun object is the core object of processor runs, and is returned by the [Run Processor](/2024-12-23/developers/processor-endpoints/run-processor) endpoint as well as the [Get Processor Run](/2024-12-23/developers/processor-endpoints/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".

---

**`id`** `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](/2024-12-23/developers/guides/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](/2024-12-23/developers/objects/file) for more details.

---

**`url`** `string`

URL to view the processor run.

---

**`Example Response`**

```json Example Response
{
  "object": "document_processor_run",
  "id": "dpr_1234",
  "output": { // Will be null until the run is processed
    // Output object - see “Processor output types” for details
  },
  "processorId": "dp_5678",
  "processorVersionId": "dpv_91011",
  "processorName": "Invoice Extractor",
  "status": "PROCESSED",
  "metadata": {
    "internal_id": "id_1234"
  },
  "reviewed": false,
  "edited": false,
  "edits": null,
  "type": "EXTRACT",
  "mergedProcessors": [],
  "config": {
    // Config object - see “Processor configs” for details
  },
  "files": [
    {
      "name": "example.pdf",
      // Other file fields, which can be found in the File object page
    }
  ],
  "url": "https://dashboard.extend.app/runs/dpr_1234"
}
```