> 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 Set Items GET https://api.extend.ai/evaluation_sets/{id}/items List all items in a specific evaluation set. Evaluation set items are the individual files and expected outputs that are used to evaluate the performance of a given processor in Extend. 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-set-items ## Authentication - `Authorization` header (bearer token, required) — Bearer authentication of the form `Bearer `, where token is your auth token. ## Request ### Path parameters - `id` (string, required) — The ID of the evaluation set to retrieve items for. Example: `"ev_2LcgeY_mp2T5yPaEuq5Lw"` ### Query parameters - `sortBy` (enum, optional, default: updatedAt) — Sorts the evaluation set items by the given field. - Allowed values: `updatedAt`, `createdAt` - `sortDir` (enum, optional, default: desc) — Sorts the evaluation set items 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 set items - `success` (boolean, required) - `evaluationSetItems` (list of EvaluationSetItem, 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 ### 404 Not Found Error Evaluation set not found - `success` (boolean, optional) - `error` (string, optional) — Error message ## Types ### EvaluationSetItem The EvaluationSetItem object represents an item in an evaluation set in Extend. Items are the individual 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_item"`. - `id` (string, required) — The ID of the evaluation set item. Example: `"evi_kR9mNP12Qw4yTv8BdR3H"` - `evaluationSetId` (string, required) — The ID of the evaluation set that this item belongs to. Example: `"ev_2LcgeY_mp2T5yPaEuq5Lw"` - `fileId` (string, required) — Extend's internal ID for the file. It will always start with "file_". Example: `"file_xK9mLPqRtN3vS8wF5hB2cQ"` - `expectedOutput` (ProvidedProcessorOutput, required) — The expected output that will be used to evaluate the processor's performance. This will confirm to the output type schema of the processor. ### ProvidedProcessorOutput ### ProvidedClassifierOutput - `id` (string, required) — The unique identifier for this classification - `type` (string, required) — The type of classification - `confidence` (double, optional, default: 1) — A value between 0 and 1 indicating the model's confidence in the classification, where 1 represents maximum confidence ### ProvidedSplitterOutput - `splits` (list of ProvidedSplitterOutputSplitsItems, required) ### ProvidedSplitterOutputSplitsItems - `id` (string, required) — Unique ID for this split - `classificationId` (string, required) — ID of the classification type (set in the processor config) - `type` (string, required) — The type of the split document (set in the processor config), corresponds to the classificationId - `startPage` (integer, required) — The start page of the split document - `endPage` (integer, required) — The end page of the split document - `observation` (string, optional) — Explanation of the results - `identifier` (string, optional) — Identifier for the split document (e.g. invoice number) ## Examples **Response** ```json { "success": true, "evaluationSetItems": [ { "object": "evaluation_set_item", "id": "evi_kR9mNP12Qw4yTv8BdR3H", "evaluationSetId": "ev_2LcgeY_mp2T5yPaEuq5Lw", "fileId": "file_xK9mLPqRtN3vS8wF5hB2cQ", "expectedOutput": { "vendor_name": { "id": "vendor_name", "type": "string", "value": "Acme Corporation", "confidence": 1 }, "invoice_number": { "id": "invoice_number", "type": "string", "value": "INV-2024-001", "confidence": 1 }, "total_amount": { "id": "total_amount", "type": "currency", "value": { "amount": 1250, "iso_4217_currency_code": "USD" }, "confidence": 1 }, "line_items": { "id": "line_items", "type": "array", "value": [ { "description": "Office Supplies", "quantity": 5, "unit_price": 25, "total": 125 }, { "description": "Software License", "quantity": 1, "unit_price": 1125, "total": 1125 } ], "confidence": 1 } } }, { "object": "evaluation_set_item", "id": "evi_7mXp9Rq3nW2vY1kT6fH4bZ", "evaluationSetId": "ev_2LcgeY_mp2T5yPaEuq5Lw", "fileId": "file_3nL8mKpR5qW9vT2fG7hY1", "expectedOutput": { "vendor_name": { "id": "vendor_name", "type": "string", "value": "Global Tech Solutions", "confidence": 1 }, "invoice_number": { "id": "invoice_number", "type": "string", "value": "GTS-2024-156", "confidence": 1 }, "total_amount": { "id": "total_amount", "type": "currency", "value": { "amount": 875.5, "iso_4217_currency_code": "USD" }, "confidence": 1 }, "line_items": { "id": "line_items", "type": "array", "value": [ { "description": "Cloud Storage", "quantity": 12, "unit_price": 45, "total": 540 }, { "description": "API Usage", "quantity": 1, "unit_price": 335.5, "total": 335.5 } ], "confidence": 1 } } }, { "object": "evaluation_set_item", "id": "evi_5kN7pQ9mR2wV8xT3fG1bY", "evaluationSetId": "ev_2LcgeY_mp2T5yPaEuq5Lw", "fileId": "file_9sL2mPrQ6tW4vX8kF5hG3", "expectedOutput": { "vendor_name": { "id": "vendor_name", "type": "string", "value": "Office Plus Ltd", "confidence": 1 }, "invoice_number": { "id": "invoice_number", "type": "string", "value": "OP-2024-789", "confidence": 1 }, "total_amount": { "id": "total_amount", "type": "currency", "value": { "amount": 342.75, "iso_4217_currency_code": "USD" }, "confidence": 1 }, "line_items": { "id": "line_items", "type": "array", "value": [ { "description": "Printer Paper", "quantity": 10, "unit_price": 12.5, "total": 125 }, { "description": "Ink Cartridges", "quantity": 3, "unit_price": 72.58, "total": 217.75 } ], "confidence": 1 } } } ], "nextPageToken": "mK9pLPqRtN3vS8wF5hB2cQ==:yWvUxYjM4nKpL7aDgE9HbTcR2mAyX3/Q+CNkfBSw1dZ=" } ```