---
title: Search LLM Observability experimentation entities
description: Datadog, the leading service for cloud-scale monitoring.
breadcrumbs: Docs > API Reference > LLM Observability
---

# Search LLM Observability experimentation entities{% #search-llm-observability-experimentation-entities %}
Copy pageCopied
{% tab title="v2" %}
**Note**: This endpoint is in preview and is subject to change. If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).
| Datadog site      | API endpoint                                                                |
| ----------------- | --------------------------------------------------------------------------- |
| ap1.datadoghq.com | POST https://api.ap1.datadoghq.com/api/v2/llm-obs/v1/experimentation/search |
| ap2.datadoghq.com | POST https://api.ap2.datadoghq.com/api/v2/llm-obs/v1/experimentation/search |
| app.datadoghq.eu  | POST https://api.datadoghq.eu/api/v2/llm-obs/v1/experimentation/search      |
| app.ddog-gov.com  | POST https://api.ddog-gov.com/api/v2/llm-obs/v1/experimentation/search      |
| us2.ddog-gov.com  | POST https://api.us2.ddog-gov.com/api/v2/llm-obs/v1/experimentation/search  |
| app.datadoghq.com | POST https://api.datadoghq.com/api/v2/llm-obs/v1/experimentation/search     |
| us3.datadoghq.com | POST https://api.us3.datadoghq.com/api/v2/llm-obs/v1/experimentation/search |
| us5.datadoghq.com | POST https://api.us5.datadoghq.com/api/v2/llm-obs/v1/experimentation/search |

### Overview



Search across LLM Observability experimentation entities — projects, datasets, dataset records, experiments, and experiment runs — using cursor-based pagination.

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

Returns `200 OK` when all results fit in a single page. Returns `206 Partial Content` with a cursor in `meta.after` when additional pages are available.



### Request

#### Body Data (required)

Experimentation search payload.

{% tab title="Model" %}

| Parent field    | Field                        | Type     | Description                                                                                                               |
| --------------- | ---------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------- |
|                 | data [*required*]       | object   | Data object for an experimentation search request.                                                                        |
| data            | attributes [*required*] | object   | Attributes for an experimentation search request.                                                                         |
| attributes      | content_preview              | object   | Options to control content preview truncation.                                                                            |
| content_preview | limit                        | int64    | Maximum number of characters to include in content previews.                                                              |
| attributes      | filter [*required*]     | object   | Filter criteria for an experimentation search request.                                                                    |
| filter          | include_deleted              | boolean  | When `true`, include soft-deleted entities alongside active ones.                                                         |
| filter          | is_deleted                   | boolean  | When `true`, return only soft-deleted entities.                                                                           |
| filter          | query                        | string   | Free-text search query.                                                                                                   |
| filter          | scope [*required*]      | [string] | Entity types to search. Valid values are `projects`, `datasets`, `dataset_records`, `experiments`, and `experiment_runs`. |
| filter          | version                      | int64    | Filter dataset records by a specific dataset version.                                                                     |
| attributes      | include                      | object   | Additional data to include in the response.                                                                               |
| include         | user_data                    | boolean  | When `true`, enrich results with author user data (name and email).                                                       |
| attributes      | page                         | object   | Cursor-based pagination parameters.                                                                                       |
| page            | cursor                       | string   | Opaque cursor returned from a previous response to fetch the next page.                                                   |
| page            | limit                        | int64    | Maximum number of results per page.                                                                                       |
| data            | type [*required*]       | enum     | Resource type for experimentation search and analytics operations. Allowed enum values: `experimentation`                 |

{% /tab %}

{% tab title="Example" %}

```json
{
  "data": {
    "attributes": {
      "content_preview": {
        "limit": 500
      },
      "filter": {
        "include_deleted": false,
        "is_deleted": false,
        "query": "my experiment",
        "scope": [
          "experiments"
        ],
        "version": "integer"
      },
      "include": {
        "user_data": false
      },
      "page": {
        "cursor": "string",
        "limit": 100
      }
    },
    "type": "experimentation"
  }
}
```

{% /tab %}

### Response

{% tab title="200" %}
OK — all results returned in a single page.
{% tab title="Model" %}
Response to a cursor-based experimentation search. Returns `200 OK` when all results fit in one page; `206 Partial Content` when a next-page cursor is available.

| Parent field    | Field                             | Type                | Description                                                                                                               |
| --------------- | --------------------------------- | ------------------- | ------------------------------------------------------------------------------------------------------------------------- |
|                 | data [*required*]            | object              | JSON:API data object for an experimentation search response.                                                              |
| data            | attributes [*required*]      | object              | The matching experimentation entities grouped by type.                                                                    |
| attributes      | dataset_records                   | [object]            | Matching dataset records. Present when `dataset_records` is included in `filter.scope`.                                   |
| dataset_records | created_at [*required*]      | date-time           | Timestamp when the record was created.                                                                                    |
| dataset_records | dataset_id [*required*]      | string              | Identifier of the dataset this record belongs to.                                                                         |
| dataset_records | expected_output [*required*] | object <oneOf> | Represents any valid JSON value.                                                                                          |
| expected_output | Option 1                          | string              | A scalar string value.                                                                                                    |
| expected_output | Option 2                          | double              | A scalar numeric value.                                                                                                   |
| expected_output | Option 3                          | object              | An arbitrary object value with additional properties.                                                                     |
| expected_output | Option 4                          | [ <oneOf>]     | An array of arbitrary values.                                                                                             |
| Option 4        | Option 1                          | string              | A scalar string value.                                                                                                    |
| Option 4        | Option 2                          | double              | A scalar numeric value.                                                                                                   |
| Option 4        | Option 3                          | object              | An arbitrary object value with additional properties.                                                                     |
| Option 4        | Option 4                          | boolean             | A scalar boolean value.                                                                                                   |
| expected_output | Option 5                          | boolean             | A scalar boolean value.                                                                                                   |
| dataset_records | id [*required*]              | string              | Unique identifier of the record.                                                                                          |
| dataset_records | input [*required*]           | object <oneOf> | Represents any valid JSON value.                                                                                          |
| input           | Option 1                          | string              | A scalar string value.                                                                                                    |
| input           | Option 2                          | double              | A scalar numeric value.                                                                                                   |
| input           | Option 3                          | object              | An arbitrary object value with additional properties.                                                                     |
| input           | Option 4                          | [ <oneOf>]     | An array of arbitrary values.                                                                                             |
| Option 4        | Option 1                          | string              | A scalar string value.                                                                                                    |
| Option 4        | Option 2                          | double              | A scalar numeric value.                                                                                                   |
| Option 4        | Option 3                          | object              | An arbitrary object value with additional properties.                                                                     |
| Option 4        | Option 4                          | boolean             | A scalar boolean value.                                                                                                   |
| input           | Option 5                          | boolean             | A scalar boolean value.                                                                                                   |
| dataset_records | metadata [*required*]        | object              | Arbitrary metadata associated with the record.                                                                            |
| dataset_records | updated_at [*required*]      | date-time           | Timestamp when the record was last updated.                                                                               |
| attributes      | datasets                          | [object]            | Matching datasets. Present when `datasets` is included in `filter.scope`.                                                 |
| datasets        | attributes [*required*]      | object              | Attributes of an LLM Observability dataset.                                                                               |
| attributes      | created_at [*required*]      | date-time           | Timestamp when the dataset was created.                                                                                   |
| attributes      | current_version [*required*] | int64               | Current version number of the dataset.                                                                                    |
| attributes      | description [*required*]     | string              | Description of the dataset.                                                                                               |
| attributes      | metadata [*required*]        | object              | Arbitrary metadata associated with the dataset.                                                                           |
| attributes      | name [*required*]            | string              | Name of the dataset.                                                                                                      |
| attributes      | updated_at [*required*]      | date-time           | Timestamp when the dataset was last updated.                                                                              |
| datasets        | id [*required*]              | string              | Unique identifier of the dataset.                                                                                         |
| datasets        | type [*required*]            | enum                | Resource type of an LLM Observability dataset. Allowed enum values: `datasets`                                            |
| attributes      | experiment_runs                   | [object]            | Matching experiment runs. Present when `experiment_runs` is included in `filter.scope`.                                   |
| experiment_runs | aggregate_data                    | object              | Aggregated metric data for this run.                                                                                      |
| experiment_runs | created_at                        | date-time           | Timestamp when the run was created.                                                                                       |
| experiment_runs | experiment_id                     | string              | Identifier of the experiment this run belongs to.                                                                         |
| experiment_runs | id                                | string              | Unique identifier of the experiment run.                                                                                  |
| experiment_runs | run_number                        | int32               | Sequential number of this run within the experiment.                                                                      |
| attributes      | experiments                       | [object]            | Matching experiments. Present when `experiments` is included in `filter.scope`.                                           |
| experiments     | aggregate_data                    | object              | Pre-computed aggregate metrics for this experiment run, including eval score distributions, token costs, and error rates. |
| experiments     | author                            | object              | User data for the author of an experiment. Only present when `include[user_data]` is `true`.                              |
| author          | email                             | string              | Email address of the user.                                                                                                |
| author          | handle                            | string              | Username or handle associated with the user's Datadog account.                                                            |
| author          | icon                              | string              | URL of the user's icon.                                                                                                   |
| author          | id                                | string              | Unique identifier of the user.                                                                                            |
| author          | name                              | string              | Display name of the user.                                                                                                 |
| experiments     | config [*required*]          | object              | Configuration parameters for the experiment.                                                                              |
| experiments     | created_at [*required*]      | date-time           | Timestamp when the experiment was created.                                                                                |
| experiments     | dataset_id [*required*]      | string              | Identifier of the dataset used in this experiment.                                                                        |
| experiments     | dataset_name                      | string              | Name of the dataset used in this experiment. Only present when `include[dataset_names]` is `true`.                        |
| experiments     | dataset_version                   | int64               | Version of the dataset used in this experiment.                                                                           |
| experiments     | deleted_at                        | date-time           | Timestamp when the experiment was soft-deleted, if applicable.                                                            |
| experiments     | description [*required*]     | string              | Description of the experiment.                                                                                            |
| experiments     | error                             | string              | Error message describing why the experiment failed, if applicable.                                                        |
| experiments     | experiment                        | string              | Logical name of the experiment, shared across all runs of the same pipeline.                                              |
| experiments     | metadata [*required*]        | object              | Arbitrary metadata associated with the experiment.                                                                        |
| experiments     | name [*required*]            | string              | Name of the experiment.                                                                                                   |
| experiments     | parent_experiment_id              | string              | Identifier of the parent (baseline) experiment this experiment was run against, if any.                                   |
| experiments     | project_id [*required*]      | string              | Identifier of the project this experiment belongs to.                                                                     |
| experiments     | run_count                         | int32               | Expected number of runs for this experiment.                                                                              |
| experiments     | status                            | enum                | Execution status of an LLM Observability experiment. Allowed enum values: `running,completed,failed,interrupted`          |
| experiments     | updated_at [*required*]      | date-time           | Timestamp when the experiment was last updated.                                                                           |
| attributes      | projects                          | [object]            | Matching projects. Present when `projects` is included in `filter.scope`.                                                 |
| projects        | attributes [*required*]      | object              | Attributes of an LLM Observability project.                                                                               |
| attributes      | created_at [*required*]      | date-time           | Timestamp when the project was created.                                                                                   |
| attributes      | description [*required*]     | string              | Description of the project.                                                                                               |
| attributes      | name [*required*]            | string              | Name of the project.                                                                                                      |
| attributes      | updated_at [*required*]      | date-time           | Timestamp when the project was last updated.                                                                              |
| projects        | id [*required*]              | string              | Unique identifier of the project.                                                                                         |
| projects        | type [*required*]            | enum                | Resource type of an LLM Observability project. Allowed enum values: `projects`                                            |
| data            | id [*required*]              | string              | Server-generated identifier for this search result.                                                                       |
| data            | type [*required*]            | enum                | Resource type for experimentation search and analytics operations. Allowed enum values: `experimentation`                 |
|                 | meta                              | object              | Pagination cursor metadata.                                                                                               |
| meta            | after                             | string              | Cursor for the next page of results.                                                                                      |

{% /tab %}

{% tab title="Example" %}

```json
{
  "data": {
    "attributes": {
      "dataset_records": [
        {
          "created_at": "2024-01-15T10:30:00Z",
          "dataset_id": "9f64e5c7-dc5a-45c8-a17c-1b85f0bec97d",
          "expected_output": {
            "description": "undefined",
            "type": "undefined"
          },
          "id": "rec-7c3f5a1b-9e2d-4f8a-b1c6-3d7e9f0a2b4c",
          "input": {
            "description": "undefined",
            "type": "undefined"
          },
          "metadata": {},
          "updated_at": "2024-01-15T10:30:00Z"
        }
      ],
      "datasets": [
        {
          "attributes": {
            "created_at": "2024-01-15T10:30:00Z",
            "current_version": 1,
            "description": "",
            "metadata": {},
            "name": "My LLM Dataset",
            "updated_at": "2024-01-15T10:30:00Z"
          },
          "id": "9f64e5c7-dc5a-45c8-a17c-1b85f0bec97d",
          "type": "datasets"
        }
      ],
      "experiment_runs": [
        {
          "aggregate_data": {},
          "created_at": "2024-01-15T10:30:00Z",
          "experiment_id": "3fd6b5e0-8910-4b1c-a7d0-5b84de329012",
          "id": "7a1b2c3d-4e5f-6789-abcd-ef0123456789",
          "run_number": 1
        }
      ],
      "experiments": [
        {
          "aggregate_data": {},
          "author": {
            "email": "jane.doe@example.com",
            "handle": "jane.doe@example.com",
            "icon": "https://example.com/icon.png",
            "id": "00000000-0000-0000-0000-000000000010",
            "name": "Jane Doe"
          },
          "config": {},
          "created_at": "2024-01-15T10:30:00Z",
          "dataset_id": "9f64e5c7-dc5a-45c8-a17c-1b85f0bec97d",
          "dataset_name": "string",
          "dataset_version": "integer",
          "deleted_at": "2019-09-19T10:00:00.000Z",
          "description": "",
          "error": "string",
          "experiment": "my-pipeline",
          "metadata": {},
          "name": "My Experiment v1",
          "parent_experiment_id": "3fd6b5e0-8910-4b1c-a7d0-5b84de329012",
          "project_id": "a33671aa-24fd-4dcd-9b33-a8ec7dde7751",
          "run_count": "integer",
          "status": "completed",
          "updated_at": "2024-01-15T10:30:00Z"
        }
      ],
      "projects": [
        {
          "attributes": {
            "created_at": "2024-01-15T10:30:00Z",
            "description": "",
            "name": "My LLM Project",
            "updated_at": "2024-01-15T10:30:00Z"
          },
          "id": "a33671aa-24fd-4dcd-9b33-a8ec7dde7751",
          "type": "projects"
        }
      ]
    },
    "id": "00000000-0000-0000-0000-000000000001",
    "type": "experimentation"
  },
  "meta": {
    "after": "string"
  }
}
```

{% /tab %}

{% /tab %}

{% tab title="206" %}
Partial Content — more results are available. Use `meta.after` as the next `page.cursor`.
{% tab title="Model" %}
Response to a cursor-based experimentation search. Returns `200 OK` when all results fit in one page; `206 Partial Content` when a next-page cursor is available.

| Parent field    | Field                             | Type                | Description                                                                                                               |
| --------------- | --------------------------------- | ------------------- | ------------------------------------------------------------------------------------------------------------------------- |
|                 | data [*required*]            | object              | JSON:API data object for an experimentation search response.                                                              |
| data            | attributes [*required*]      | object              | The matching experimentation entities grouped by type.                                                                    |
| attributes      | dataset_records                   | [object]            | Matching dataset records. Present when `dataset_records` is included in `filter.scope`.                                   |
| dataset_records | created_at [*required*]      | date-time           | Timestamp when the record was created.                                                                                    |
| dataset_records | dataset_id [*required*]      | string              | Identifier of the dataset this record belongs to.                                                                         |
| dataset_records | expected_output [*required*] | object <oneOf> | Represents any valid JSON value.                                                                                          |
| expected_output | Option 1                          | string              | A scalar string value.                                                                                                    |
| expected_output | Option 2                          | double              | A scalar numeric value.                                                                                                   |
| expected_output | Option 3                          | object              | An arbitrary object value with additional properties.                                                                     |
| expected_output | Option 4                          | [ <oneOf>]     | An array of arbitrary values.                                                                                             |
| Option 4        | Option 1                          | string              | A scalar string value.                                                                                                    |
| Option 4        | Option 2                          | double              | A scalar numeric value.                                                                                                   |
| Option 4        | Option 3                          | object              | An arbitrary object value with additional properties.                                                                     |
| Option 4        | Option 4                          | boolean             | A scalar boolean value.                                                                                                   |
| expected_output | Option 5                          | boolean             | A scalar boolean value.                                                                                                   |
| dataset_records | id [*required*]              | string              | Unique identifier of the record.                                                                                          |
| dataset_records | input [*required*]           | object <oneOf> | Represents any valid JSON value.                                                                                          |
| input           | Option 1                          | string              | A scalar string value.                                                                                                    |
| input           | Option 2                          | double              | A scalar numeric value.                                                                                                   |
| input           | Option 3                          | object              | An arbitrary object value with additional properties.                                                                     |
| input           | Option 4                          | [ <oneOf>]     | An array of arbitrary values.                                                                                             |
| Option 4        | Option 1                          | string              | A scalar string value.                                                                                                    |
| Option 4        | Option 2                          | double              | A scalar numeric value.                                                                                                   |
| Option 4        | Option 3                          | object              | An arbitrary object value with additional properties.                                                                     |
| Option 4        | Option 4                          | boolean             | A scalar boolean value.                                                                                                   |
| input           | Option 5                          | boolean             | A scalar boolean value.                                                                                                   |
| dataset_records | metadata [*required*]        | object              | Arbitrary metadata associated with the record.                                                                            |
| dataset_records | updated_at [*required*]      | date-time           | Timestamp when the record was last updated.                                                                               |
| attributes      | datasets                          | [object]            | Matching datasets. Present when `datasets` is included in `filter.scope`.                                                 |
| datasets        | attributes [*required*]      | object              | Attributes of an LLM Observability dataset.                                                                               |
| attributes      | created_at [*required*]      | date-time           | Timestamp when the dataset was created.                                                                                   |
| attributes      | current_version [*required*] | int64               | Current version number of the dataset.                                                                                    |
| attributes      | description [*required*]     | string              | Description of the dataset.                                                                                               |
| attributes      | metadata [*required*]        | object              | Arbitrary metadata associated with the dataset.                                                                           |
| attributes      | name [*required*]            | string              | Name of the dataset.                                                                                                      |
| attributes      | updated_at [*required*]      | date-time           | Timestamp when the dataset was last updated.                                                                              |
| datasets        | id [*required*]              | string              | Unique identifier of the dataset.                                                                                         |
| datasets        | type [*required*]            | enum                | Resource type of an LLM Observability dataset. Allowed enum values: `datasets`                                            |
| attributes      | experiment_runs                   | [object]            | Matching experiment runs. Present when `experiment_runs` is included in `filter.scope`.                                   |
| experiment_runs | aggregate_data                    | object              | Aggregated metric data for this run.                                                                                      |
| experiment_runs | created_at                        | date-time           | Timestamp when the run was created.                                                                                       |
| experiment_runs | experiment_id                     | string              | Identifier of the experiment this run belongs to.                                                                         |
| experiment_runs | id                                | string              | Unique identifier of the experiment run.                                                                                  |
| experiment_runs | run_number                        | int32               | Sequential number of this run within the experiment.                                                                      |
| attributes      | experiments                       | [object]            | Matching experiments. Present when `experiments` is included in `filter.scope`.                                           |
| experiments     | aggregate_data                    | object              | Pre-computed aggregate metrics for this experiment run, including eval score distributions, token costs, and error rates. |
| experiments     | author                            | object              | User data for the author of an experiment. Only present when `include[user_data]` is `true`.                              |
| author          | email                             | string              | Email address of the user.                                                                                                |
| author          | handle                            | string              | Username or handle associated with the user's Datadog account.                                                            |
| author          | icon                              | string              | URL of the user's icon.                                                                                                   |
| author          | id                                | string              | Unique identifier of the user.                                                                                            |
| author          | name                              | string              | Display name of the user.                                                                                                 |
| experiments     | config [*required*]          | object              | Configuration parameters for the experiment.                                                                              |
| experiments     | created_at [*required*]      | date-time           | Timestamp when the experiment was created.                                                                                |
| experiments     | dataset_id [*required*]      | string              | Identifier of the dataset used in this experiment.                                                                        |
| experiments     | dataset_name                      | string              | Name of the dataset used in this experiment. Only present when `include[dataset_names]` is `true`.                        |
| experiments     | dataset_version                   | int64               | Version of the dataset used in this experiment.                                                                           |
| experiments     | deleted_at                        | date-time           | Timestamp when the experiment was soft-deleted, if applicable.                                                            |
| experiments     | description [*required*]     | string              | Description of the experiment.                                                                                            |
| experiments     | error                             | string              | Error message describing why the experiment failed, if applicable.                                                        |
| experiments     | experiment                        | string              | Logical name of the experiment, shared across all runs of the same pipeline.                                              |
| experiments     | metadata [*required*]        | object              | Arbitrary metadata associated with the experiment.                                                                        |
| experiments     | name [*required*]            | string              | Name of the experiment.                                                                                                   |
| experiments     | parent_experiment_id              | string              | Identifier of the parent (baseline) experiment this experiment was run against, if any.                                   |
| experiments     | project_id [*required*]      | string              | Identifier of the project this experiment belongs to.                                                                     |
| experiments     | run_count                         | int32               | Expected number of runs for this experiment.                                                                              |
| experiments     | status                            | enum                | Execution status of an LLM Observability experiment. Allowed enum values: `running,completed,failed,interrupted`          |
| experiments     | updated_at [*required*]      | date-time           | Timestamp when the experiment was last updated.                                                                           |
| attributes      | projects                          | [object]            | Matching projects. Present when `projects` is included in `filter.scope`.                                                 |
| projects        | attributes [*required*]      | object              | Attributes of an LLM Observability project.                                                                               |
| attributes      | created_at [*required*]      | date-time           | Timestamp when the project was created.                                                                                   |
| attributes      | description [*required*]     | string              | Description of the project.                                                                                               |
| attributes      | name [*required*]            | string              | Name of the project.                                                                                                      |
| attributes      | updated_at [*required*]      | date-time           | Timestamp when the project was last updated.                                                                              |
| projects        | id [*required*]              | string              | Unique identifier of the project.                                                                                         |
| projects        | type [*required*]            | enum                | Resource type of an LLM Observability project. Allowed enum values: `projects`                                            |
| data            | id [*required*]              | string              | Server-generated identifier for this search result.                                                                       |
| data            | type [*required*]            | enum                | Resource type for experimentation search and analytics operations. Allowed enum values: `experimentation`                 |
|                 | meta                              | object              | Pagination cursor metadata.                                                                                               |
| meta            | after                             | string              | Cursor for the next page of results.                                                                                      |

{% /tab %}

{% tab title="Example" %}

```json
{
  "data": {
    "attributes": {
      "dataset_records": [
        {
          "created_at": "2024-01-15T10:30:00Z",
          "dataset_id": "9f64e5c7-dc5a-45c8-a17c-1b85f0bec97d",
          "expected_output": {
            "description": "undefined",
            "type": "undefined"
          },
          "id": "rec-7c3f5a1b-9e2d-4f8a-b1c6-3d7e9f0a2b4c",
          "input": {
            "description": "undefined",
            "type": "undefined"
          },
          "metadata": {},
          "updated_at": "2024-01-15T10:30:00Z"
        }
      ],
      "datasets": [
        {
          "attributes": {
            "created_at": "2024-01-15T10:30:00Z",
            "current_version": 1,
            "description": "",
            "metadata": {},
            "name": "My LLM Dataset",
            "updated_at": "2024-01-15T10:30:00Z"
          },
          "id": "9f64e5c7-dc5a-45c8-a17c-1b85f0bec97d",
          "type": "datasets"
        }
      ],
      "experiment_runs": [
        {
          "aggregate_data": {},
          "created_at": "2024-01-15T10:30:00Z",
          "experiment_id": "3fd6b5e0-8910-4b1c-a7d0-5b84de329012",
          "id": "7a1b2c3d-4e5f-6789-abcd-ef0123456789",
          "run_number": 1
        }
      ],
      "experiments": [
        {
          "aggregate_data": {},
          "author": {
            "email": "jane.doe@example.com",
            "handle": "jane.doe@example.com",
            "icon": "https://example.com/icon.png",
            "id": "00000000-0000-0000-0000-000000000010",
            "name": "Jane Doe"
          },
          "config": {},
          "created_at": "2024-01-15T10:30:00Z",
          "dataset_id": "9f64e5c7-dc5a-45c8-a17c-1b85f0bec97d",
          "dataset_name": "string",
          "dataset_version": "integer",
          "deleted_at": "2019-09-19T10:00:00.000Z",
          "description": "",
          "error": "string",
          "experiment": "my-pipeline",
          "metadata": {},
          "name": "My Experiment v1",
          "parent_experiment_id": "3fd6b5e0-8910-4b1c-a7d0-5b84de329012",
          "project_id": "a33671aa-24fd-4dcd-9b33-a8ec7dde7751",
          "run_count": "integer",
          "status": "completed",
          "updated_at": "2024-01-15T10:30:00Z"
        }
      ],
      "projects": [
        {
          "attributes": {
            "created_at": "2024-01-15T10:30:00Z",
            "description": "",
            "name": "My LLM Project",
            "updated_at": "2024-01-15T10:30:00Z"
          },
          "id": "a33671aa-24fd-4dcd-9b33-a8ec7dde7751",
          "type": "projects"
        }
      ]
    },
    "id": "00000000-0000-0000-0000-000000000001",
    "type": "experimentation"
  },
  "meta": {
    "after": "string"
  }
}
```

{% /tab %}

{% /tab %}

{% tab title="400" %}
Bad Request
{% tab title="Model" %}
API error response.

| Parent field | Field                    | Type     | Description                                                                     |
| ------------ | ------------------------ | -------- | ------------------------------------------------------------------------------- |
|              | errors [*required*] | [object] | A list of errors.                                                               |
| errors       | detail                   | string   | A human-readable explanation specific to this occurrence of the error.          |
| errors       | meta                     | object   | Non-standard meta-information about the error                                   |
| errors       | source                   | object   | References to the source of the error.                                          |
| source       | header                   | string   | A string indicating the name of a single request header which caused the error. |
| source       | parameter                | string   | A string indicating which URI query parameter caused the error.                 |
| source       | pointer                  | string   | A JSON pointer to the value in the request document that caused the error.      |
| errors       | status                   | string   | Status code of the response.                                                    |
| errors       | title                    | string   | Short human-readable summary of the error.                                      |

{% /tab %}

{% tab title="Example" %}

```json
{
  "errors": [
    {
      "detail": "Missing required attribute in body",
      "meta": {},
      "source": {
        "header": "Authorization",
        "parameter": "limit",
        "pointer": "/data/attributes/title"
      },
      "status": "400",
      "title": "Bad Request"
    }
  ]
}
```

{% /tab %}

{% /tab %}

{% tab title="401" %}
Unauthorized
{% tab title="Model" %}
API error response.

| Parent field | Field                    | Type     | Description                                                                     |
| ------------ | ------------------------ | -------- | ------------------------------------------------------------------------------- |
|              | errors [*required*] | [object] | A list of errors.                                                               |
| errors       | detail                   | string   | A human-readable explanation specific to this occurrence of the error.          |
| errors       | meta                     | object   | Non-standard meta-information about the error                                   |
| errors       | source                   | object   | References to the source of the error.                                          |
| source       | header                   | string   | A string indicating the name of a single request header which caused the error. |
| source       | parameter                | string   | A string indicating which URI query parameter caused the error.                 |
| source       | pointer                  | string   | A JSON pointer to the value in the request document that caused the error.      |
| errors       | status                   | string   | Status code of the response.                                                    |
| errors       | title                    | string   | Short human-readable summary of the error.                                      |

{% /tab %}

{% tab title="Example" %}

```json
{
  "errors": [
    {
      "detail": "Missing required attribute in body",
      "meta": {},
      "source": {
        "header": "Authorization",
        "parameter": "limit",
        "pointer": "/data/attributes/title"
      },
      "status": "400",
      "title": "Bad Request"
    }
  ]
}
```

{% /tab %}

{% /tab %}

{% tab title="403" %}
Forbidden
{% tab title="Model" %}
API error response.

| Parent field | Field                    | Type     | Description                                                                     |
| ------------ | ------------------------ | -------- | ------------------------------------------------------------------------------- |
|              | errors [*required*] | [object] | A list of errors.                                                               |
| errors       | detail                   | string   | A human-readable explanation specific to this occurrence of the error.          |
| errors       | meta                     | object   | Non-standard meta-information about the error                                   |
| errors       | source                   | object   | References to the source of the error.                                          |
| source       | header                   | string   | A string indicating the name of a single request header which caused the error. |
| source       | parameter                | string   | A string indicating which URI query parameter caused the error.                 |
| source       | pointer                  | string   | A JSON pointer to the value in the request document that caused the error.      |
| errors       | status                   | string   | Status code of the response.                                                    |
| errors       | title                    | string   | Short human-readable summary of the error.                                      |

{% /tab %}

{% tab title="Example" %}

```json
{
  "errors": [
    {
      "detail": "Missing required attribute in body",
      "meta": {},
      "source": {
        "header": "Authorization",
        "parameter": "limit",
        "pointer": "/data/attributes/title"
      },
      "status": "400",
      "title": "Bad Request"
    }
  ]
}
```

{% /tab %}

{% /tab %}

{% tab title="429" %}
Too many requests
{% tab title="Model" %}
API error response.

| Field                    | Type     | Description       |
| ------------------------ | -------- | ----------------- |
| errors [*required*] | [string] | A list of errors. |

{% /tab %}

{% tab title="Example" %}

```json
{
  "errors": [
    "Bad Request"
  ]
}
```

{% /tab %}

{% /tab %}

{% tab title="500" %}
Internal Server Error
{% tab title="Model" %}
API error response.

| Parent field | Field                    | Type     | Description                                                                     |
| ------------ | ------------------------ | -------- | ------------------------------------------------------------------------------- |
|              | errors [*required*] | [object] | A list of errors.                                                               |
| errors       | detail                   | string   | A human-readable explanation specific to this occurrence of the error.          |
| errors       | meta                     | object   | Non-standard meta-information about the error                                   |
| errors       | source                   | object   | References to the source of the error.                                          |
| source       | header                   | string   | A string indicating the name of a single request header which caused the error. |
| source       | parameter                | string   | A string indicating which URI query parameter caused the error.                 |
| source       | pointer                  | string   | A JSON pointer to the value in the request document that caused the error.      |
| errors       | status                   | string   | Status code of the response.                                                    |
| errors       | title                    | string   | Short human-readable summary of the error.                                      |

{% /tab %}

{% tab title="Example" %}

```json
{
  "errors": [
    {
      "detail": "Missing required attribute in body",
      "meta": {},
      "source": {
        "header": "Authorization",
        "parameter": "limit",
        "pointer": "/data/attributes/title"
      },
      "status": "400",
      "title": "Bad Request"
    }
  ]
}
```

{% /tab %}

{% /tab %}

### Code Example

##### 
                  \## default
# 
 \# Curl command curl -X POST "https://api.datadoghq.com/api/v2/llm-obs/v1/experimentation/search" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "DD-API-KEY: ${DD_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_APP_KEY}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "filter": {
        "query": "@project_id:a33671aa-24fd-4dcd-9b33-a8ec7dde7751",
        "scope": [
          "experiments"
        ]
      },
      "page": {
        "limit": 50
      }
    },
    "type": "experimentation"
  }
}
EOF 
                
{% /tab %}
