> 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.

# Get Processor Run

A common use case for this endpoint is to poll for the status and final output of an async processor run when using the [Run Processor](/2024-12-23/developers/processor-endpoints/run-processor) endpoint. For instance, if you do not want to not configure webhooks to receive the output via completion/failure events.

### URL Parameters

**`id`** `string` — required

The unique identifier of the processor run to retrieve.

---

### Response

**`success`** `boolean`

A true or false value indicating whether the request was successful.

---

**`processorRun`** `object`

Details about the requested processor run. See the [ProcessorRun object](/2024-12-23/developers/objects/processor-run) for more details.

---

**`Example Request with cURL`**

```bash Example Request with cURL
curl --location --request GET 'https://api-prod.extend.app/processor_runs/dpr_1234' \
--header 'Authorization: Bearer <API_TOKEN>'
```

**`Node.js`**

```javascript Node.js
const getProcessorRun = async (processorRunId) => {
  const response = await fetch(
    `https://api-prod.extend.app/processor_runs/${processorRunId}`,
    {
      headers: {
        Authorization: "Bearer <API_TOKEN>",
      },
    }
  );

  if (!response.ok) {
    if (response.status === 404) {
      console.error("Processor run not found");
    } else {
      const error = await response.json();
      console.error("Error:", error);
    }
    return;
  }

  const data = await response.json();
  console.log("Processor run details:", data);
};

getProcessorRun("dpr_1234");
```

**`Python`**

```python Python
import requests

def get_processor_run(processor_run_id):
    url = f"https://api-prod.extend.app/processor_runs/{processor_run_id}"
    headers = {
        "Authorization": "Bearer <API_TOKEN>"
    }

    try:
        response = requests.get(url, headers=headers)
        response.raise_for_status()
        print("Processor run details:", response.json())
    except requests.exceptions.HTTPError as e:
        if e.response.status_code == 404:
            print("Processor run not found")
        else:
            print("Error:", e)
    except requests.exceptions.RequestException as e:
        print("Error:", e)

get_processor_run('dpr_1234')
```

**`Example Response`**

```json Example Response
{
  "success": true,
  "processorRun": {
    "object": "document_processor_run",
    "id": "dpr_1234",
    "processorId": "dp_5678",
    "processorVersionId": "dpv_91011",
    "processorName": "Invoice Extractor",
    "status": "PROCESSED",
    "metadata": {
      "internal_id": "id_1234"
    },
    "reviewed": true,
    "edited": true,
    "edits": {
      "total_amount": {
        "originalValue": "1000.00",
        "editedValue": "1100.00",
        "fieldType": "currency",
        "notes": "Corrected after tax calculation"
      }
    },
    "type": "EXTRACT",
    "config": {
      // Config object - see “Processor configs” for details
    },
    "initialOutput": {
      // Output object - see “Processor output types” for details
    },
    "reviewedOutput": {
      // Output object - see “Processor output types” for details
    },
    "output": {
      // Output object - see “Processor output types” for details
    },
    "files": [
      {
        "name": "invoice.pdf"
      }
    ],
    "url": "https://platform.extend.app/processor-runs/dpr_1234"
  }
}
```