Get dataset items | Opik Documentation

curl http://localhost:5173/api/v1/private/datasets/id/items \
     -H "Content-Type: application/json"

{
  "content": [
    {
      "source": "manual",
      "data": {
        "image_url": "https://example.com/images/sample1.png",
        "label": "cat",
        "metadata": {
          "resolution": "1024x768",
          "format": "png"
        }
      },
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "dataset_item_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "trace_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "span_id": "1c9e6679-7425-40de-944b-e07fc1f90ae7",
      "description": "Image of a domestic cat sitting on a windowsill.",
      "tags": [
        "animal",
        "cat",
        "indoor"
      ],
      "evaluators": [
        {
          "name": "Image Quality Judge",
          "type": "llm_judge",
          "config": {
            "threshold": 0.85,
            "criteria": [
              "clarity",
              "lighting"
            ]
          }
        }
      ],
      "execution_policy": {
        "runs_per_item": 5,
        "pass_threshold": 3
      },
      "experiment_items": [
        {
          "experiment_id": "d4e5f6a7-b8c9-4d0e-9f1a-2b3c4d5e6f7a",
          "dataset_item_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "trace_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
          "id": "9b2d6f3a-4f3a-4d3a-9f3a-4f3a9b2d6f3a",
          "project_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
          "created_at": "2024-01-15T09:30:00Z",
          "last_updated_at": "2024-01-15T09:30:00Z",
          "created_by": "jane.doe@example.com",
          "last_updated_by": "jane.doe@example.com",
          "trace_visibility_mode": "default"
        }
      ],
      "run_summaries_by_experiment": {
        "d4e5f6a7-b8c9-4d0e-9f1a-2b3c4d5e6f7a": {
          "passed_runs": 4,
          "total_runs": 5,
          "status": "passed"
        }
      },
      "dataset_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "created_at": "2024-01-15T09:30:00Z",
      "last_updated_at": "2024-01-15T09:30:00Z",
      "created_by": "jane.doe@example.com",
      "last_updated_by": "jane.doe@example.com"
    }
  ],
  "page": 1,
  "size": 1,
  "total": 1,
  "columns": [
    {
      "name": "label",
      "types": [
        "string"
      ],
      "filter_field_prefix": "data",
      "filterField": "data.label"
    }
  ],
  "sortableBy": [
    "created_at",
    "last_updated_at",
    "label"
  ]
}

Get dataset items

Path parameters

idstringRequiredformat: "uuid"

Query parameters

pageintegerOptional>=1Defaults to 1

sizeintegerOptional>=1Defaults to 10

versionstringOptional

filtersstringOptional

truncatebooleanOptional

Response

Dataset items resource

contentlist of objects

pageinteger

sizeinteger

totallong

columnslist of objects

sortableBylist of strings