---
title: "Simple search experimentation entities"
method: POST
path: "/api/v2/llm-obs/v1/experimentation/simple-search"
tags: ["LLM Observability"]
---

# Simple search experimentation entities

`POST /api/v2/llm-obs/v1/experimentation/simple-search`

Search across LLM Observability experimentation entities using offset-based (page-number) pagination.
Use this endpoint when you need total page count or want to navigate to a specific page number.

The `filter.scope` field controls which entity types are returned. At least one valid scope must be provided.

## Request body

- LLMObsExperimentationSimpleSearchRequest — Request to search across LLM Observability experimentation entities using offset-based pagination.
  - `data` LLMObsExperimentationSimpleSearchDataRequest, required — Data object for an experimentation simple search request.
    - `attributes` LLMObsExperimentationSimpleSearchDataAttributesRequest, required — Attributes for an experimentation simple search request.
      - `content_preview` LLMObsExperimentationContentPreview — Options to control content preview truncation.
        - `limit` integer — Maximum number of characters to include in content previews.
      - `filter` LLMObsExperimentationFilter, required — Filter criteria for an experimentation search request.
        - `include_deleted` boolean — When `true`, include soft-deleted entities alongside active ones.
        - `is_deleted` boolean — When `true`, return only soft-deleted entities.
        - `query` string — Free-text search query.
        - `scope` string[], required — Entity types to search. Valid values are `projects`, `datasets`, `dataset_records`, `experiments`, and `experiment_runs`.
        - `version` integer, nullable — Filter dataset records by a specific dataset version.
      - `include` LLMObsExperimentationInclude — Additional data to include in the response.
        - `user_data` boolean — When `true`, enrich results with author user data (name and email).
      - `page` LLMObsExperimentationNumberPage — Offset-based pagination parameters for simple search.
        - `limit` integer — Maximum number of results per page.
        - `number` integer — Page number to retrieve (1-indexed).
      - `sort` LLMObsExperimentationSortField[] — Sort order for results.
        - `direction` 'asc' | 'desc' — Sort direction.
        - `field` string, required — The field name to sort on.
    - `type` 'experimentation', required — Resource type for experimentation search and analytics operations.

## Response `200`

OK

- LLMObsExperimentationSimpleSearchResponse — Response to an offset-based experimentation simple search.
  - `data` LLMObsExperimentationSimpleSearchDataResponse, required — JSON:API data object for a simple search response.
    - `attributes` LLMObsExperimentationSearchResults, required — The matching experimentation entities grouped by type.
      - `dataset_records` LLMObsDatasetRecordDataResponse[], nullable — Matching dataset records. Present when `dataset_records` is included in `filter.scope`.
        - `created_at` string, date-time, required — Timestamp when the record was created.
        - `dataset_id` string, required — Identifier of the dataset this record belongs to.
        - `expected_output` AnyValue, nullable, required — An arbitrary object value with additional properties.
        - `id` string, required — Unique identifier of the record.
        - `input` AnyValue, nullable, required — An arbitrary object value with additional properties.
        - `metadata` object, nullable, required — Arbitrary metadata associated with the record.
        - `updated_at` string, date-time, required — Timestamp when the record was last updated.
      - `datasets` LLMObsDatasetDataResponse[], nullable — Matching datasets. Present when `datasets` is included in `filter.scope`.
        - `attributes` LLMObsDatasetDataAttributesResponse, required — Attributes of an LLM Observability dataset.
          - `created_at` string, date-time, required — Timestamp when the dataset was created.
          - `current_version` integer, required — Current version number of the dataset.
          - `description` string, nullable, required — Description of the dataset.
          - `metadata` object, nullable, required — Arbitrary metadata associated with the dataset.
          - `name` string, required — Name of the dataset.
          - `updated_at` string, date-time, required — Timestamp when the dataset was last updated.
        - `id` string, required — Unique identifier of the dataset.
        - `type` 'datasets', required — Resource type of an LLM Observability dataset.
      - `experiment_runs` LLMObsExperimentRunDataResponse[], nullable — Matching experiment runs. Present when `experiment_runs` is included in `filter.scope`.
        - `aggregate_data` object, nullable — Aggregated metric data for this run.
        - `created_at` string, date-time — Timestamp when the run was created.
        - `experiment_id` string — Identifier of the experiment this run belongs to.
        - `id` string — Unique identifier of the experiment run.
        - `run_number` integer — Sequential number of this run within the experiment.
      - `experiments` LLMObsExperimentDataAttributesResponse[], nullable — Matching experiments. Present when `experiments` is included in `filter.scope`.
        - `aggregate_data` object, nullable — Pre-computed aggregate metrics for this experiment run, including eval score distributions, token costs, and error rates.
        - `author` LLMObsExperimentUser — User data for the author of an experiment. Only present when `include[user_data]` is `true`.
          - `email` string — Email address of the user.
          - `handle` string — Username or handle associated with the user's Datadog account.
          - `icon` string — URL of the user's icon.
          - `id` string — Unique identifier of the user.
          - `name` string — Display name of the user.
        - `config` object, nullable, required — Configuration parameters for the experiment.
        - `created_at` string, date-time, required — Timestamp when the experiment was created.
        - `dataset_id` string, required — Identifier of the dataset used in this experiment.
        - `dataset_name` string, nullable — Name of the dataset used in this experiment. Only present when `include[dataset_names]` is `true`.
        - `dataset_version` integer — Version of the dataset used in this experiment.
        - `deleted_at` string, date-time, nullable — Timestamp when the experiment was soft-deleted, if applicable.
        - `description` string, nullable, required — Description of the experiment.
        - `error` string, nullable — Error message describing why the experiment failed, if applicable.
        - `experiment` string — Logical name of the experiment, shared across all runs of the same pipeline.
        - `metadata` object, nullable, required — Arbitrary metadata associated with the experiment.
        - `name` string, required — Name of the experiment.
        - `parent_experiment_id` string, nullable — Identifier of the parent (baseline) experiment this experiment was run against, if any.
        - `project_id` string, required — Identifier of the project this experiment belongs to.
        - `run_count` integer — Expected number of runs for this experiment.
        - `status` 'running' | 'completed' | 'failed' | 'interrupted' — Execution status of an LLM Observability experiment.
        - `updated_at` string, date-time, required — Timestamp when the experiment was last updated.
      - `projects` LLMObsProjectDataResponse[], nullable — Matching projects. Present when `projects` is included in `filter.scope`.
        - `attributes` LLMObsProjectDataAttributesResponse, required — Attributes of an LLM Observability project.
          - `created_at` string, date-time, required — Timestamp when the project was created.
          - `description` string, nullable, required — Description of the project.
          - `name` string, required — Name of the project.
          - `updated_at` string, date-time, required — Timestamp when the project was last updated.
        - `id` string, required — Unique identifier of the project.
        - `type` 'projects', required — Resource type of an LLM Observability project.
    - `id` string, required — Server-generated identifier for this search result.
    - `type` 'experimentation', required — Resource type for experimentation search and analytics operations.
  - `meta` LLMObsExperimentationSimpleSearchMeta — Pagination metadata for a simple search response.
    - `page` LLMObsExperimentationSimpleSearchMetaPage — Page metadata.
      - `current` integer — Current page number.
      - `limit` integer — Page size used for this response.
      - `total_count` integer — Total number of matching results (capped at the maximum search limit).
      - `total_pages` integer — Total number of pages available.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `429` — Too many requests
- `500` — Internal Server Error

---

[API](https://skmtc.net/datadog/apis/api-v2.md) · [All operations](https://skmtc.net/datadog/apis/api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datadog/api-v2/revisions/da68bf029e4c/schema)