> 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 Evaluation Set Items GET https://api.extend.ai/evaluation_sets/{evaluationSetId}/items List items in a specific evaluation set. Returns a summary of each evaluation set item. Use the [Get Evaluation Set Item](https://docs.extend.ai/2026-02-09/api-reference/endpoints/evaluation/get-evaluation-set-item) endpoint to get the full details of an evaluation set item. Reference: https://docs.extend.ai/api-reference/endpoints/evaluation/list-evaluation-set-items ## Authentication - `Authorization` header (bearer token, required) — Bearer authentication of the form `Bearer `, 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 - `evaluationSetId` (string, required) — The ID of the evaluation set. Example: `"ev_2LcgeY_mp2T5yPaEuq5Lw"` ### Query parameters - `sortBy` (enum, optional, default: updatedAt) — Sort by the given field. - Allowed values: `updatedAt`, `createdAt` - `sortDir` (enum, optional, default: desc) — Sort in ascending or descending order. Ascending order means the earliest result 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. - `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` ("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 List of evaluation set items - `object` (enum, required) - Allowed values: `list` - `data` (list of EvaluationSetItemSummary, 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. ## Errors ### 400 Bad Request Error Standard error response format for all Extend API errors. See the [Error Codes documentation](https://docs.extend.ai/2026-02-09/api-reference/error-handling) for error handling recommendations. - `code` (string, required) — Error code for programmatic handling. - `message` (string, required) — Human-readable error message suitable for displaying to developers. Do not rely on the exact text of this message as it may change. - `retryable` (boolean, required) — Whether the request can be retried. When true, retry with exponential backoff. When false, fix the underlying issue before retrying. - `requestId` (string, optional) — Unique request identifier for support purposes. Always include this when contacting Extend support about an error. - `docUrl` (string, optional) — Link to relevant documentation when one is available. ### 401 Unauthorized Error Standard error response format for all Extend API errors. See the [Error Codes documentation](https://docs.extend.ai/2026-02-09/api-reference/error-handling) for error handling recommendations. - `code` (string, required) — Error code for programmatic handling. - `message` (string, required) — Human-readable error message suitable for displaying to developers. Do not rely on the exact text of this message as it may change. - `retryable` (boolean, required) — Whether the request can be retried. When true, retry with exponential backoff. When false, fix the underlying issue before retrying. - `requestId` (string, optional) — Unique request identifier for support purposes. Always include this when contacting Extend support about an error. - `docUrl` (string, optional) — Link to relevant documentation when one is available. ### 402 Payment Required Error Standard error response format for all Extend API errors. See the [Error Codes documentation](https://docs.extend.ai/2026-02-09/api-reference/error-handling) for error handling recommendations. - `code` (string, required) — Error code for programmatic handling. - `message` (string, required) — Human-readable error message suitable for displaying to developers. Do not rely on the exact text of this message as it may change. - `retryable` (boolean, required) — Whether the request can be retried. When true, retry with exponential backoff. When false, fix the underlying issue before retrying. - `requestId` (string, optional) — Unique request identifier for support purposes. Always include this when contacting Extend support about an error. - `docUrl` (string, optional) — Link to relevant documentation when one is available. ### 403 Forbidden Error Standard error response format for all Extend API errors. See the [Error Codes documentation](https://docs.extend.ai/2026-02-09/api-reference/error-handling) for error handling recommendations. - `code` (string, required) — Error code for programmatic handling. - `message` (string, required) — Human-readable error message suitable for displaying to developers. Do not rely on the exact text of this message as it may change. - `retryable` (boolean, required) — Whether the request can be retried. When true, retry with exponential backoff. When false, fix the underlying issue before retrying. - `requestId` (string, optional) — Unique request identifier for support purposes. Always include this when contacting Extend support about an error. - `docUrl` (string, optional) — Link to relevant documentation when one is available. ### 404 Not Found Error Standard error response format for all Extend API errors. See the [Error Codes documentation](https://docs.extend.ai/2026-02-09/api-reference/error-handling) for error handling recommendations. - `code` (string, required) — Error code for programmatic handling. - `message` (string, required) — Human-readable error message suitable for displaying to developers. Do not rely on the exact text of this message as it may change. - `retryable` (boolean, required) — Whether the request can be retried. When true, retry with exponential backoff. When false, fix the underlying issue before retrying. - `requestId` (string, optional) — Unique request identifier for support purposes. Always include this when contacting Extend support about an error. - `docUrl` (string, optional) — Link to relevant documentation when one is available. ### 422 Unprocessable Entity Error Standard error response format for all Extend API errors. See the [Error Codes documentation](https://docs.extend.ai/2026-02-09/api-reference/error-handling) for error handling recommendations. - `code` (string, required) — Error code for programmatic handling. - `message` (string, required) — Human-readable error message suitable for displaying to developers. Do not rely on the exact text of this message as it may change. - `retryable` (boolean, required) — Whether the request can be retried. When true, retry with exponential backoff. When false, fix the underlying issue before retrying. - `requestId` (string, optional) — Unique request identifier for support purposes. Always include this when contacting Extend support about an error. - `docUrl` (string, optional) — Link to relevant documentation when one is available. ### 429 Too Many Requests Error Standard error response format for all Extend API errors. See the [Error Codes documentation](https://docs.extend.ai/2026-02-09/api-reference/error-handling) for error handling recommendations. - `code` (string, required) — Error code for programmatic handling. - `message` (string, required) — Human-readable error message suitable for displaying to developers. Do not rely on the exact text of this message as it may change. - `retryable` (boolean, required) — Whether the request can be retried. When true, retry with exponential backoff. When false, fix the underlying issue before retrying. - `requestId` (string, optional) — Unique request identifier for support purposes. Always include this when contacting Extend support about an error. - `docUrl` (string, optional) — Link to relevant documentation when one is available. ### 500 Internal Server Error Standard error response format for all Extend API errors. See the [Error Codes documentation](https://docs.extend.ai/2026-02-09/api-reference/error-handling) for error handling recommendations. - `code` (string, required) — Error code for programmatic handling. - `message` (string, required) — Human-readable error message suitable for displaying to developers. Do not rely on the exact text of this message as it may change. - `retryable` (boolean, required) — Whether the request can be retried. When true, retry with exponential backoff. When false, fix the underlying issue before retrying. - `requestId` (string, optional) — Unique request identifier for support purposes. Always include this when contacting Extend support about an error. - `docUrl` (string, optional) — Link to relevant documentation when one is available. ## Types ### EvaluationSetItemSummary - `object` (enum, required) — The type of object. In this case, it will always be `"evaluation_set_item"`. - Allowed values: `evaluation_set_item` - `id` (string, required) — The ID of the evaluation set item. Example: `"evi_kR9mNP12Qw4yTv8BdR3H"` - `file` (FileSummary, required, nullable) — A summary of the file associated with the evaluation set item. `null` for multifile items (use `files` instead). - `files` (list of FileSummary, required, nullable) — The files associated with a multifile evaluation set item, in the order they were submitted. Only populated for items created with `fileIds`. For single-file items, this is `null` — use `file` instead. - `createdBy` (CreatedBy, required) — The actor that created this resource. * `user` — the resource was created via the studio by a logged-in user. The user's `email` is exposed. * `api_key` — the resource was created via the API using an API key. The key's `name` is exposed. May be `null` for resources created before attribution. ### FileSummary - `object` (enum, required) — The type of object. Will always be `"file"`. - Allowed values: `file` - `id` (string, required) — ID for the file. Example: `"file_xK9mLPqRtN3vS8wF5hB2cQ"` - `name` (string, required) — The name of the file Example: `"Invoices.pdf"` - `type` (enum, required, nullable) — The type of the file. **Availability:** Present when the file type could be determined. - Allowed values: `PDF`, `CSV`, `IMG`, `TXT`, `DOCX`, `EXCEL`, `XML`, `HTML` - `parentFileId` (string, required, nullable) — ID of the parent file. **Availability:** Present for files created via a Splitter in a workflow. - `metadata` (FileMetadata, required) - `createdAt` (string, required) — The time (in UTC) at which the object was created. Will follow the RFC 3339 format. Example: `"2024-03-21T16:45:00Z"` - `updatedAt` (string, required) — The time (in UTC) at which the object was last updated. Will follow the RFC 3339 format. Example: `"2024-03-21T16:45:00Z"` ### CreatedBy The actor that created this resource. * `user` — the resource was created via the studio by a logged-in user. The user's `email` is exposed. * `api_key` — the resource was created via the API using an API key. The key's `name` is exposed. May be `null` for resources created before attribution. - `type`: `user` (user) - `email` (string, required) — The email address of the user who created the resource. - `type`: `api_key` (api_key) - `name` (string, required) — The name of the API key that created the resource. ### FileMetadata - `pageCount` (double, optional) — The number of pages in the file. This is only set for PDF/DOCX files. - `parentSplit` (ParentSplit, optional) — The split metadata details for a derivative file. **Availability:** Only included if this file is a derivative of another file, for instance if it was created via a Splitter in a workflow. ### ParentSplit The split metadata details for a derivative file. **Availability:** Only included if this file is a derivative of another file, for instance if it was created via a Splitter in a workflow. - `id` (string, required) — The ID of the split. - `type` (string, required) — The type of the split. - `identifier` (string, required) — The identifier of the split. - `startPage` (integer, required) — The start page of the split. - `endPage` (integer, required) — The end page of the split. ## Examples **Response** ```json { "object": "list", "data": [ { "object": "evaluation_set_item", "id": "evi_kR9mNP12Qw4yTv8BdR3H", "file": { "object": "file", "id": "file_xK9mLPqRtN3vS8wF5hB2cQ", "name": "Invoices.pdf", "type": "PDF", "parentFileId": "file_Zk9mNP12Qw4yTv8BdR3H", "metadata": { "pageCount": 30, "parentSplit": { "id": "string", "type": "Invoice", "identifier": "other_2_9", "startPage": 1, "endPage": 10 } }, "createdAt": "2024-03-21T16:45:00Z", "updatedAt": "2024-03-21T16:45:00Z" }, "files": [ { "object": "file", "id": "file_xK9mLPqRtN3vS8wF5hB2cQ", "name": "Invoices.pdf", "type": "PDF", "parentFileId": "file_Zk9mNP12Qw4yTv8BdR3H", "metadata": { "pageCount": 30, "parentSplit": { "id": "string", "type": "Invoice", "identifier": "other_2_9", "startPage": 1, "endPage": 10 } }, "createdAt": "2024-03-21T16:45:00Z", "updatedAt": "2024-03-21T16:45:00Z" } ], "createdBy": { "type": "user", "email": "matt@extend.app" } } ], "nextPageToken": "xK9mLPqRtN3vS8wF5hB2cQ==:zWvUxYjM4nKpL7aDgE9HbTcR2mAyX3/Q+CNkfBSw1dZ=" } ```