> This page is for version v2026-02-09 (default).
> 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 Batch Processor Run

GET https://api.extend.ai/batch_processor_runs/{id}

Retrieve details about a batch processor run, including evaluation runs.

**Deprecated:** This endpoint is maintained for backwards compatibility only and will be replaced in a future API version. Use [Get Evaluation Set Run](https://docs.extend.ai/2026-02-09/api-reference/endpoints/evaluation/get-evaluation-set-run) for interacting with evaluation set runs.


Reference: https://docs.extend.ai/api-reference/endpoints/legacy/get-batch-processor-run

## Authentication

- `Authorization` header (bearer token, required) — Bearer authentication of the form `Bearer <token>`, where token is your auth token.

## Servers

- `https://api.extend.ai` (Production, default)
- `https://api.us2.extend.app` (Production US2)
- `https://api.eu1.extend.ai` (Production EU1)

## Request

### Path parameters

- `id` (string, required) — The unique identifier of the batch processor run to retrieve. Example: `"bpr_Xj8mK2pL9nR4vT7qY5wZ"`

### Headers

- `x-extend-api-version` ("2026-02-09", optional, default: 2026-02-09) — API version to use for the request. If you're using an SDK, you can ignore this parameter. If you are not using an SDK and do not specify a version, you will either receive a `400 Bad Request` or be set to a previous legacy version. See [API Versioning](https://docs.extend.ai/2026-02-09/api-reference/api-versioning) for more details.
- `x-extend-workspace-id` (string, optional) — The workspace ID to target. **Required** when using an organization-scoped API key; optional for workspace-scoped keys (the key is already tied to a workspace). See [Authentication](https://docs.extend.ai/2026-02-09/api-reference/authentication) for details on API key scopes.

## Response

### 200

Successfully retrieved batch processor run

- `success` (boolean, required)
- `batchProcessorRun` (LegacyBatchProcessorRun, required)

## Errors

### 400 Bad Request Error

Bad Request

- `success` (boolean, optional)
- `error` (string, optional) — Error message

### 401 Unauthorized Error

Unauthorized

- `success` (boolean, optional)
- `error` (string, optional) — Error message

### 404 Not Found Error

Not Found

- `success` (boolean, optional)
- `error` (string, optional) — Error message

## Types

### LegacyBatchProcessorRun

- `object` (string, required) — The type of response. In this case, it will always be `"batch_processor_run"`.
- `id` (string, required) — The unique identifier for this batch processor run. Example: `"batch_processor_run_Xj8mK2pL9nR4vT7qY5wZ"`
- `processorId` (string, required) — The ID of the processor used for this run. Example: `"ex_Xj8mK2pL9nR4vT7qY5wZ"`
- `processorVersionId` (string, required) — The ID of the specific processor version used. Example: `"exv_xK9mLPqRtN3vS8wF5hB2cQ"`
- `processorName` (string, required) — The name of the processor. Example: `"Invoice Processor"`
- `metrics` (LegacyBatchProcessorRunMetrics, required)
- `status` (enum, required) — The current status of the batch processor run: * `"PENDING"` - The batch processor run is waiting to start * `"PROCESSING"` - The batch processor run is in progress * `"PROCESSED"` - The batch processor run completed successfully * `"FAILED"` - The batch processor run encountered an error
  - Allowed values: `PENDING`, `PROCESSING`, `PROCESSED`, `FAILED`
- `source` (enum, required) — The source of the batch processor run: * `"EVAL_SET"` - The batch processor run was made from an evaluation set. The `sourceId` will be the ID of the evaluation set (e.g., `"ev_1234"`) * `"PLAYGROUND"` - The batch processor run was made from the playground. The `sourceId` will not be set * `"STUDIO"` - The batch processor run was made for a processor in Studio. The `sourceId` will be the ID of the processor (e.g., `"ex_1234"`)
  - Allowed values: `EVAL_SET`, `PLAYGROUND`, `STUDIO`
- `runCount` (integer, required) — The number of runs that were made.
- `options` (LegacyBatchProcessorRunOptions, required) — The options for the batch processor run.
- `createdAt` (string, required) — The time (in UTC) at which the batch processor run was created. Will follow the RFC 3339 format. Example: `"2024-03-21T15:30:00Z"`
- `updatedAt` (string, required) — The time (in UTC) at which the batch processor run was last updated. Will follow the RFC 3339 format. Example: `"2024-03-21T16:45:00Z"`
- `sourceId` (string, optional) — The ID of the source of the batch processor run. See the `source` field for more details. Example: `"ev_1234"` for EVAL_SET source, `"ex_1234"` for STUDIO source

### LegacyBatchProcessorRunMetrics

- `numFiles` (double, optional) — The total number of files processed in this batch run
- `numPages` (double, optional) — The total number of pages processed in this batch run

### LegacyBatchProcessorRunOptions

The options for the batch processor run.

- `fuzzyMatchFields` (list of string, optional) — The fields that were fuzzy matched.
- `excludeFields` (list of string, optional) — The fields that were excluded from the run.

## Examples

**Response**

```json
{
  "success": true,
  "batchProcessorRun": {
    "object": "batch_processor_run",
    "id": "batch_processor_run_Xj8mK2pL9nR4vT7qY5wZ",
    "processorId": "ex_Xj8mK2pL9nR4vT7qY5wZ",
    "processorVersionId": "exv_xK9mLPqRtN3vS8wF5hB2cQ",
    "processorName": "Invoice Processor",
    "metrics": {
      "numFiles": 1.1,
      "numPages": 1.1
    },
    "status": "PROCESSING",
    "source": "EVAL_SET",
    "runCount": 1,
    "options": {
      "fuzzyMatchFields": [
        "string"
      ],
      "excludeFields": [
        "string"
      ]
    },
    "createdAt": "2024-03-21T15:30:00Z",
    "updatedAt": "2024-03-21T16:45:00Z",
    "sourceId": "ev_1234"
  }
}
```