---
title: "POST /v1/experiment/query"
method: POST
path: "/v1/experiment/query"
tags: ["Experiment"]
---

# POST /v1/experiment/query

`POST /v1/experiment/query`

## Request body

- object
  - `include` IncludeExperimentKeys
    - `inputs` true
    - `promptVersion` true
    - `responseBodies` true
    - `score` true
  - `filter` union, required
    - FilterLeafSubsetExperiment — From T, pick a set of properties whose keys are in the union K
      - `experiment` PartialExperimentToOperators — Make all properties in T optional
        - `id` PartialTextOperators — Make all properties in T optional
          - `not-equals` string
          - `equals` string
          - `like` string
          - `ilike` string
          - `contains` string
          - `not-contains` string
        - `prompt_v2` PartialTextOperators — Make all properties in T optional
          - `not-equals` string
          - `equals` string
          - `like` string
          - `ilike` string
          - `contains` string
          - `not-contains` string
    - ExperimentFilterBranch
      - `right` ExperimentFilterNode, required — recursive
      - `operator` 'or' | 'and', required
      - `left` ExperimentFilterNode, required — recursive
    - 'all'

## Response `200`

Ok

- union
  - ResultSuccessExperimentArray
    - `data` Experiment[], required
      - `id` string, required
      - `organization` string, required
      - `dataset` object, required
        - `rows` ExperimentDatasetRow[], required
          - `rowId` string, required
          - `inputRecord` object, required
            - `request` RequestObj, required
              - …
            - `response` ResponseObj, required
              - …
            - `autoInputs` RecordStringString[], required
              - …
            - `inputs` RecordStringString, required — Construct a type with a set of properties K of type T
            - `requestPath` string, required
            - `requestId` string, required
            - `id` string, required
          - `rowIndex` number, double, required
          - `columnId` string, required
          - `scores` RecordStringScore, required — Construct a type with a set of properties K of type T
        - `name` string, required
        - `id` string, required
      - `meta` unknown, required
      - `createdAt` string, required
      - `hypotheses` object[], required
        - `runs` object[], required
          - `request` RequestObj
            - `id` string, required
            - `provider` string, required
          - `scores` RecordStringScore, required — Construct a type with a set of properties K of type T
          - `response` ResponseObj
            - `body` unknown, required
            - `createdAt` string, required
            - `completionTokens` number, double, required
            - `promptTokens` number, double, required
            - `promptCacheWriteTokens` number, double, required
            - `promptCacheReadTokens` number, double, required
            - `delayMs` number, double, required
            - `model` string, required
          - `resultRequestId` string, required
          - `datasetRowId` string, required
        - `providerKey` string, required
        - `createdAt` string, required
        - `status` string, required
        - `model` string, required
        - `parentPromptVersion` object
          - `template` unknown, required
        - `promptVersion` object
          - `template` unknown, required
        - `promptVersionId` string, required
        - `id` string, required
      - `scores` ExperimentScores, required
        - `dataset` object, required
          - `scores` RecordStringScore, required — Construct a type with a set of properties K of type T
        - `hypothesis` object, required
          - `scores` RecordStringScore, required — Construct a type with a set of properties K of type T
          - `runsCount` number, double, required
      - `tableId` string, nullable, required
    - `error` null, nullable, required
  - ResultErrorString
    - `data` null, nullable, required
    - `error` string, required

---

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