---
title: "Find optimizations"
method: GET
path: "/v1/private/optimizations"
tags: ["Optimizations"]
---

# Find optimizations

`GET /v1/private/optimizations`

Find optimizations

## Query parameters

- `page` integer
- `size` integer
- `dataset_id` string, uuid
- `name` string — Filter optimizations by name (partial match, case insensitive)
- `dataset_name` string — Filter optimizations by dataset name (partial match)
- `dataset_deleted` boolean
- `project_id` string, uuid
- `filters` string

## Response `200`

Optimizations resource

- OptimizationPagePublic
  - `page` integer
  - `size` integer
  - `total` integer
  - `content` OptimizationPublic[]
    - `id` string, uuid
    - `name` string
    - `dataset_name` string, required
    - `project_id` string, uuid — Project ID. Takes precedence over project_name when both are provided.
    - `objective_name` string, required
    - `status` 'running' | 'completed' | 'cancelled' | 'initialized' | 'error', required
    - `metadata` JsonListStringPublic
    - `studio_config` OptimizationStudioConfigPublic
      - `dataset_name` string, required
      - `prompt` StudioPromptPublic, required
        - `messages` StudioMessagePublic[], required
          - `role` string, required
          - `content` string, required
      - `llm_model` StudioLlmModelPublic, required
        - `model` string, required
        - `parameters` JsonNodePublic
      - `evaluation` StudioEvaluationPublic, required
        - `metrics` StudioMetricPublic[], required
          - `type` string, required
          - `parameters` JsonNodePublic
      - `optimizer` StudioOptimizerPublic, required
        - `type` string, required
        - `parameters` JsonNodePublic
    - `error_info` ErrorInfoPublic
      - `exception_type` string, required
      - `message` string
      - `traceback` string, required
    - `dataset_id` string, uuid
    - `num_trials` integer
    - `feedback_scores` FeedbackScoreAveragePublic[]
      - `name` string, required
      - `value` number, required
    - `experiment_scores` FeedbackScoreAveragePublic[]
      - `name` string, required
      - `value` number, required
    - `created_at` string, date-time
    - `created_by` string
    - `last_updated_at` string, date-time
    - `last_updated_by` string
    - `baseline_objective_score` number
    - `best_objective_score` number
    - `baseline_duration` number
    - `best_duration` number
    - `baseline_cost` number
    - `best_cost` number
    - `total_optimization_cost` number
  - `sortableBy` string[]

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/comet-ml/apis/opik-rest-api.md) · [All operations](https://skmtc.net/comet-ml/apis/opik-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/comet-ml/opik-rest-api/versions/4ed2fbc97cc3/schema)