Get Evaluation Set Item | Extend Documentation

from extend_ai import Extend
client = Extend(
    token="YOUR_TOKEN_HERE",
    extend_api_version="2026-02-09",
)
client.evaluation_set_items.retrieve(
    evaluation_set_id="evaluation_set_id_here",
    item_id="evaluation_set_item_id_here",
)

{
  "object": "evaluation_set_item",
  "id": "evi_kR9mNP12Qw4yTv8BdR3H",
  "evaluationSetId": "ev_2LcgeY_mp2T5yPaEuq5Lw",
  "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"
    }
  ],
  "expectedOutput": {
    "value": {}
  },
  "createdBy": {
    "type": "user",
    "email": "matt@extend.app"
  }
}

Get details of an evaluation set item.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

evaluationSetIdstringRequired

The ID of the evaluation set.

Example: "ev_2LcgeY_mp2T5yPaEuq5Lw"

itemIdstringRequired

The ID of the evaluation set item.

Example: "evi_kR9mNP12Qw4yTv8BdR3H"

Headers

Response

Evaluation set item details

objectenum

The type of object. In this case, it will always be "evaluation_set_item".

Allowed values:

idstring

The ID of the evaluation set item.

Example: "evi_kR9mNP12Qw4yTv8BdR3H"

evaluationSetIdstring

The ID of the evaluation set that this item belongs to.

Example: "ev_2LcgeY_mp2T5yPaEuq5Lw"

fileobject or null

A summary of the file associated with the evaluation set item. null for multifile items (use files instead).

fileslist of objects or null

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.

expectedOutputobject

The expected output that will be used to evaluate the performance of the extractor, classifier, or splitter associated with the evaluation set. This must conform to the output schema of the entity associated with the evaluation set.

createdByobject

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.

Errors

400

Bad Request Error

401

Unauthorized Error

402

Payment Required Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

429

Too Many Requests Error

500

Internal Server Error