---
title: "GET /api/{org_id}/experiments"
method: GET
path: "/api/{org_id}/experiments"
tags: ["Experiments"]
---

# GET /api/{org_id}/experiments

`GET /api/{org_id}/experiments`

## Request

- Base URL: `https://api.openobserve.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.openobserve.ai/api/{org_id}/experiments`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/openobserve/apis/openobserve-api-http/docs/api/:org_id/experiments/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `org_id` string, required

## Query parameters

- `includeSummary` boolean, nullable
- `datasetId` string, nullable
- `promptId` string, nullable
- `promptVersion` integer, nullable
- `contentHash` string, nullable

## Response `200`

- object
  - `list` ExperimentViewResponseBody[], required
    - `createdAt` integer, required
    - `createdBy` string, required
    - `datasetFilter` DatasetSnapshotFilterBody
      - `logicalIds` string[]
      - `metadata` object
      - `sources` DatasetItemSourceBody[]
      - `tags` string[]
    - `datasetId` string, required
    - `datasetName` string, nullable: Resolved from the Dataset the experiment pinned, so callers do not have to fetch the Dataset list just to label a run. None when it was deleted.
    - `datasetVersion` integer, required: The pinned `global_version`: the row cut every Slot reads.
    - `datasetWriteVersion` integer, required: The Dataset version to display for that pin: one per write request.
    - `deadlineAt` integer, required
    - `description` string, nullable
    - `executionCompletedAt` integer, nullable
    - `executionStatus` 'pending' | 'running' | 'completed' | 'failed' | 'cancelled', required
    - `executionStatusReason` string, nullable
    - `id` string, required
    - `idempotencyKey` string, nullable
    - `isBaseline` boolean, required: The organization's Baseline for this Dataset. At most one Experiment per organization and Dataset carries it.
    - `lifecycleVersion` integer, required
    - `metadata` unknown
    - `name` string, required
    - `orgId` string, required
    - `promptContentHash` string, nullable
    - `promptId` string, nullable
    - `promptName` string, nullable
    - `promptVersion` integer, nullable
    - `retryCount` integer, required
    - `scorers` PinnedExperimentScorerBody[], required
      - `id` string, required
      - `version` integer, required
    - `task` union, required
      - object
        - `messages` PromptMessageBody[], required
          - `content` string, required
          - `role` string, required
        - `model` string, nullable
        - `params` unknown
        - `provider_id` string, required
        - `type` 'inline_prompt', required
      - object
        - `id` string, required
        - `params_overrides` PromptRefOverridesBody
          - `model` string, nullable
          - `params` unknown
          - `responseFormat` unknown
          - `tools` unknown
        - `provider_id` string, required
        - `type` 'prompt_ref', required
        - `version` integer, required
      - object
        - `overrides` RemoteTaskOverridesBody: The two runtime overrides an Experiment may set on a registered Remote Task.
          - `maxConcurrency` integer, nullable
          - `timeoutMs` integer, nullable
        - `task_ref` string, required: Pinned `name@version` of a published Remote Task. Never latest.
        - `type` 'remote', required
      - object
        - `config` unknown
        - `task_fingerprint` string, required: Immutable identity of the customer code under evaluation. Every execution record reported for this Experiment must repeat it.
        - `type` 'sdk', required
    - `trialCount` integer, required
    - `aggregateSummary` ExperimentAggregateSummaryBody
      - `costIncomplete` boolean, required
      - `errorTaskSlots` integer, required
      - `failureCauseCount` integer, required: Distinct failure causes across every errored slot.
      - `failureCauses` ExperimentFailureCauseBody[], required: Top 3 failure causes, largest first: errored slots grouped by kind, by first line if none.
        - `kind` string, nullable: Shared failure taxonomy (`provider_auth`, `timeout`, `execution_error`, …); absent when the producer did not classify the failure, including current SDK/client paths.
        - `message` string, required: The group's most common first error line.
        - `slotCount` integer, required
      - `incomplete` boolean, required
      - `incompleteScoreDimensions` integer, required
      - `incompleteTaskSlots` integer, required
      - `p50LatencyMs` integer, nullable
      - `scoringCost` number, double, nullable
      - `taskCost` number, double, required
      - `totalCost` number, double, required
    - `executionProgress` ExperimentProgressBody
      - `completed` integer, required
      - `skipped` integer, required
      - `total` integer, required
    - `scoreOutcomes` ExperimentScoreOutcomesBody: `completed` is scored plus failed; `total` also counts pending, skipped and unscored.
      - `completed` integer, required
      - `failed` integer, required
      - `pending` integer, required
      - `scored` integer, required
      - `skipped` integer, required
      - `total` integer, required
      - `unscored` integer, required
    - `scoreSummaries` ExperimentScoreSummaryBody[], nullable
      - `errorCount` integer, required
      - `name` string, required: User-facing dimension label. This is the Score Config name when the Scorer declares one, otherwise the Scorer name.
      - `noReferenceCount` integer, required
      - `noTraceCount` integer, required
      - `pendingCount` integer, required
      - `sampleCount` integer, required
      - `scoreConfigId` string, nullable
      - `scoreConfigName` string, nullable
      - `scoreConfigVersion` integer, nullable
      - `scorerId` string, required
      - `scorerVersion` integer, required
      - `skippedCount` integer, required
      - `value` unknown
    - `scoringProgress` ExperimentProgressBody
      - `completed` integer, required
      - `skipped` integer, required
      - `total` integer, required
    - `scoringStatus` string, nullable
    - `status` 'pending' | 'running' | 'scoring' | 'completed' | 'cancelled' | 'execution_failed' | 'scoring_failed'
    - `taskOutcomes` ExperimentTaskOutcomesBody: Slot counts over the pinned set; `pending` is `total` minus the slots that have finished.
      - `failed` integer, required
      - `pending` integer, required
      - `skipped` integer, required
      - `succeeded` integer, required
      - `total` integer, required

---

[API](https://skmtc.dev/openobserve/apis/openobserve-api-http.md) - [All operations](https://skmtc.dev/openobserve/apis/openobserve-api-http/llms.txt) - [OpenAPI document](https://skmtc.dev/openobserve/apis/openobserve-api-http/revisions/0529b8a10252?raw)