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

# List Processors

GET https://api.extend.ai/processors

List all processors in your organization

Reference: https://docs.extend.ai/api-reference/endpoints/legacy/list-processors

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

### Query parameters

- `type` (enum, optional) — Filter processors by type
  - Allowed values: `EXTRACT`, `CLASSIFY`, `SPLITTER`
- `nextPageToken` (string, optional) — Token for retrieving the next page of results
- `maxPageSize` (integer, optional, default: 25) — Maximum number of processors to return per page
- `sortBy` (enum, optional, default: updatedAt) — Field to sort by
  - Allowed values: `createdAt`, `updatedAt`
- `sortDir` (enum, optional, default: desc) — Sort direction
  - Allowed values: `asc`, `desc`

### 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 processors

- `success` (boolean, required) — Indicates the request was successful
- `processors` (list of LegacyListProcessorsProcessor, required) — Array of processors
- `warning` (string, optional, nullable) — Optional warning message
- `nextPageToken` (string, optional, nullable) — Token for retrieving the next page of results. Will be null if there are no more results.

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

### 429 Too Many Requests Error

Rate Limited

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

### 500 Internal Server Error

Internal Server Error

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

## Types

### LegacyListProcessorsProcessor

- `object` (enum, required) — The type of response. In this case, it will always be `"document_processor"`.
  - Allowed values: `document_processor`
- `id` (string, required) — The ID of the processor. Example: `"ex_Xj8mK2pL9nR4vT7qY5wZ"`
- `name` (string, required) — The name of the processor. Example: `"Invoice Processor"`
- `type` (enum, required) — The type of processor: * `"EXTRACT"` - Extracts structured data from documents * `"CLASSIFY"` - Classifies documents into categories * `"SPLITTER"` - Splits documents into multiple parts
  - Allowed values: `EXTRACT`, `CLASSIFY`, `SPLITTER`
- `versions` (list of LegacyListProcessorsProcessorVersion, required) — Array of all versions for this processor
- `createdAt` (string, required) — The time (in UTC) at which the processor was created. Will follow the RFC 3339 format. Example: `"2024-03-21T15:30:00Z"`
- `updatedAt` (string, required) — The time (in UTC) at which the processor was last updated. Will follow the RFC 3339 format. Example: `"2024-03-21T16:45:00Z"`

### LegacyListProcessorsProcessorVersion

- `id` (string, required) — The unique identifier for this version of the document processor. Example: `"exv_xK9mLPqRtN3vS8wF5hB2cQ"`
- `version` (string, required) — The version number or identifier for this processor version. Example: `"3"`

## Examples

**Response**

```json
{
  "success": true,
  "processors": [
    {
      "object": "document_processor",
      "id": "ex_Xj8mK2pL9nR4vT7qY5wZ",
      "name": "Invoice Processor",
      "type": "EXTRACT",
      "versions": [
        {
          "id": "exv_xK9mLPqRtN3vS8wF5hB2cQ",
          "version": "3"
        }
      ],
      "createdAt": "2024-03-21T15:30:00Z",
      "updatedAt": "2024-03-21T16:45:00Z"
    }
  ],
  "warning": "string",
  "nextPageToken": "string"
}
```