> This page is for version v2025-04-21.
> 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 Evaluation Sets

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

List evaluation sets in your account. You can use the `processorId` parameter to filter evaluation sets by processor. 

This endpoint returns a paginated response. You can use the `nextPageToken` to fetch subsequent results.


Reference: https://docs.extend.ai/2025-04-21/developers/api-reference/evaluation-set-endpoints/list-evaluation-sets

## Authentication

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

## Request

### Query parameters

- `processorId` (string, optional) — The ID of the processor to filter evaluation sets by. Example: `"dp_Xj8mK2pL9nR4vT7qY5wZ"`
- `sortBy` (enum, optional, default: updatedAt) — Sorts the evaluation sets by the given field.
  - Allowed values: `updatedAt`, `createdAt`
- `sortDir` (enum, optional, default: desc) — Sorts the evaluation sets in ascending or descending order. Ascending order means the earliest evaluation set is returned first.
  - Allowed values: `asc`, `desc`
- `nextPageToken` (string, optional) — The token used to fetch the page of results from a previous request. We use cursor based pagination and will return a `nextPageToken` in the response if there are more results. Note that if other parameters are changed in subsequent requests, you may receive inconsistent data. example: `"xK9mLPqRtN3vS8wF5hB2cQ==:zWvUxYjM4nKpL7aDgE9HbTcR2mAyX3/Q+CNkfBSw1dZ="`
- `maxPageSize` (integer, optional, default: 10) — The maximum number of results to return in the response. You may receive less than this number if there are fewer results than the maximum.

### Headers

- `x-extend-api-version` ("2025-04-21", optional, default: 2025-04-21) — API version to use for the request. If you 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/2025-04-21/developers/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/2025-04-21/developers/authentication) for details on API key scopes.

## Response

### 200

Successfully retrieved evaluation sets

- `success` (boolean, required)
- `evaluationSets` (list of EvaluationSet, required)
- `nextPageToken` (string, optional) — The token used to fetch the page of results from a previous request. We use cursor based pagination and will return a `nextPageToken` in the response if there are more results. Note that if other parameters are changed in subsequent requests, you may receive inconsistent data. example: `"xK9mLPqRtN3vS8wF5hB2cQ==:zWvUxYjM4nKpL7aDgE9HbTcR2mAyX3/Q+CNkfBSw1dZ="`

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

## Types

### EvaluationSet

The EvaluationSet object represents an evaluation set in Extend. Evaluation sets are collections of files and expected outputs that are used to evaluate the performance of a given processor in Extend.

- `object` (string, required) — The type of response. In this case, it will always be `"evaluation_set"`.
- `id` (string, required) — The ID of the evaluation set. Example: `"ev_2LcgeY_mp2T5yPaEuq5Lw"`
- `name` (string, required) — The name of the evaluation set. Example: `"Invoice Processing Test Set"`
- `description` (string, required) — A description of the evaluation set. Example: `"Q4 2023 vendor invoices for accuracy testing"`
- `processorId` (string, required) — The ID of the processor associated with this evaluation set. Example: `"dp_Xj8mK2pL9nR4vT7qY5wZ"`
- `createdAt` (string, required) — The time (in UTC) at which the evaluation set was created. Will follow the RFC 3339 format. Example: `"2024-03-21T15:30:00Z"`
- `updatedAt` (string, required) — The time (in UTC) at which the evaluation set was last updated. Will follow the RFC 3339 format. Example: `"2024-03-21T16:45:00Z"`

## Examples

**Response**

```json
{
  "success": true,
  "evaluationSets": [
    {
      "object": "evaluation_set",
      "id": "ev_2LcgeY_mp2T5yPaEuq5Lw",
      "name": "Invoice Processing Test Set",
      "description": "Q4 2023 vendor invoices for accuracy testing",
      "processorId": "dp_Xj8mK2pL9nR4vT7qY5wZ",
      "createdAt": "2024-03-21T15:30:00Z",
      "updatedAt": "2024-03-21T16:45:00Z"
    },
    {
      "object": "evaluation_set",
      "id": "ev_8mXp9Rq3nW2vY1kT6fH4bZ",
      "name": "Receipt Classification Test Set",
      "description": "Mixed receipt types for classification accuracy",
      "processorId": "dp_Bm8nQ2rL5pK9wF3dR7hY6",
      "createdAt": "2024-03-15T09:20:00Z",
      "updatedAt": "2024-03-20T14:30:00Z"
    },
    {
      "object": "evaluation_set",
      "id": "ev_5kN7pQ9mR2wV8xT3fG1bY",
      "name": "Contract Splitting Eval Set",
      "description": "Multi-page contracts for document splitting evaluation",
      "processorId": "dp_4vX8mL6nP9rQ2sW5kF3hT",
      "createdAt": "2024-03-10T11:45:00Z",
      "updatedAt": "2024-03-18T10:15:00Z"
    }
  ],
  "nextPageToken": "xK9mLPqRtN3vS8wF5hB2cQ==:zWvUxYjM4nKpL7aDgE9HbTcR2mAyX3/Q+CNkfBSw1dZ="
}
```