---
title: "POST /v1/evals/query"
method: POST
path: "/v1/evals/query"
tags: ["Evals"]
---

# POST /v1/evals/query

`POST /v1/evals/query`

## Request body

- EvalQueryParams
  - `filter` union, required
    - FilterLeafSubsetRequestResponseRmt — From T, pick a set of properties whose keys are in the union K
      - `request_response_rmt` PartialRequestResponseRMTToOperators — Make all properties in T optional
        - `country_code` PartialTextOperators — Make all properties in T optional
          - `not-equals` string
          - `equals` string
          - `like` string
          - `ilike` string
          - `contains` string
          - `not-contains` string
        - `latency` PartialNumberOperators — Make all properties in T optional
          - `not-equals` number, double
          - `equals` number, double
          - `gte` number, double
          - `lte` number, double
          - `lt` number, double
          - `gt` number, double
        - `cost` PartialNumberOperators — Make all properties in T optional
          - `not-equals` number, double
          - `equals` number, double
          - `gte` number, double
          - `lte` number, double
          - `lt` number, double
          - `gt` number, double
        - `provider` PartialTextOperators — Make all properties in T optional
          - `not-equals` string
          - `equals` string
          - `like` string
          - `ilike` string
          - `contains` string
          - `not-contains` string
        - `time_to_first_token` PartialNumberOperators — Make all properties in T optional
          - `not-equals` number, double
          - `equals` number, double
          - `gte` number, double
          - `lte` number, double
          - `lt` number, double
          - `gt` number, double
        - `status` PartialNumberOperators — Make all properties in T optional
          - `not-equals` number, double
          - `equals` number, double
          - `gte` number, double
          - `lte` number, double
          - `lt` number, double
          - `gt` number, double
        - `request_created_at` PartialTimestampOperatorsTyped — Make all properties in T optional
          - `equals` string, date-time
          - `gte` string, date-time
          - `lte` string, date-time
          - `lt` string, date-time
          - `gt` string, date-time
        - `response_created_at` PartialTimestampOperatorsTyped — Make all properties in T optional
          - `equals` string, date-time
          - `gte` string, date-time
          - `lte` string, date-time
          - `lt` string, date-time
          - `gt` string, date-time
        - `model` PartialTextOperators — Make all properties in T optional
          - `not-equals` string
          - `equals` string
          - `like` string
          - `ilike` string
          - `contains` string
          - `not-contains` string
        - `user_id` PartialTextOperators — Make all properties in T optional
          - `not-equals` string
          - `equals` string
          - `like` string
          - `ilike` string
          - `contains` string
          - `not-contains` string
        - `organization_id` PartialTextOperators — Make all properties in T optional
          - `not-equals` string
          - `equals` string
          - `like` string
          - `ilike` string
          - `contains` string
          - `not-contains` string
        - `node_id` PartialTextOperators — Make all properties in T optional
          - `not-equals` string
          - `equals` string
          - `like` string
          - `ilike` string
          - `contains` string
          - `not-contains` string
        - `job_id` PartialTextOperators — Make all properties in T optional
          - `not-equals` string
          - `equals` string
          - `like` string
          - `ilike` string
          - `contains` string
          - `not-contains` string
        - `threat` PartialBooleanOperators — Make all properties in T optional
          - `equals` boolean
        - `request_id` PartialTextOperators — Make all properties in T optional
          - `not-equals` string
          - `equals` string
          - `like` string
          - `ilike` string
          - `contains` string
          - `not-contains` string
        - `prompt_tokens` PartialNumberOperators — Make all properties in T optional
          - `not-equals` number, double
          - `equals` number, double
          - `gte` number, double
          - `lte` number, double
          - `lt` number, double
          - `gt` number, double
        - `completion_tokens` PartialNumberOperators — Make all properties in T optional
          - `not-equals` number, double
          - `equals` number, double
          - `gte` number, double
          - `lte` number, double
          - `lt` number, double
          - `gt` number, double
        - `prompt_cache_read_tokens` PartialNumberOperators — Make all properties in T optional
          - `not-equals` number, double
          - `equals` number, double
          - `gte` number, double
          - `lte` number, double
          - `lt` number, double
          - `gt` number, double
        - `prompt_cache_write_tokens` PartialNumberOperators — Make all properties in T optional
          - `not-equals` number, double
          - `equals` number, double
          - `gte` number, double
          - `lte` number, double
          - `lt` number, double
          - `gt` number, double
        - `total_tokens` PartialNumberOperators — Make all properties in T optional
          - `not-equals` number, double
          - `equals` number, double
          - `gte` number, double
          - `lte` number, double
          - `lt` number, double
          - `gt` number, double
        - `target_url` PartialTextOperators — Make all properties in T optional
          - `not-equals` string
          - `equals` string
          - `like` string
          - `ilike` string
          - `contains` string
          - `not-contains` string
        - `property_key` object
          - `equals` string, required
        - `properties` object
        - `search_properties` object
        - `scores` object
        - `scores_column` PartialTextOperators — Make all properties in T optional
          - `not-equals` string
          - `equals` string
          - `like` string
          - `ilike` string
          - `contains` string
          - `not-contains` string
        - `request_body` PartialTextOperators — Make all properties in T optional
          - `not-equals` string
          - `equals` string
          - `like` string
          - `ilike` string
          - `contains` string
          - `not-contains` string
        - `response_body` PartialTextOperators — Make all properties in T optional
          - `not-equals` string
          - `equals` string
          - `like` string
          - `ilike` string
          - `contains` string
          - `not-contains` string
        - `cache_enabled` PartialBooleanOperators — Make all properties in T optional
          - `equals` boolean
        - `cache_reference_id` PartialTextOperators — Make all properties in T optional
          - `not-equals` string
          - `equals` string
          - `like` string
          - `ilike` string
          - `contains` string
          - `not-contains` string
        - `cached` PartialBooleanOperators — Make all properties in T optional
          - `equals` boolean
        - `assets` PartialTextOperators — Make all properties in T optional
          - `not-equals` string
          - `equals` string
          - `like` string
          - `ilike` string
          - `contains` string
          - `not-contains` string
        - `helicone-score-feedback` PartialBooleanOperators — Make all properties in T optional
          - `equals` boolean
        - `prompt_id` PartialTextOperators — Make all properties in T optional
          - `not-equals` string
          - `equals` string
          - `like` string
          - `ilike` string
          - `contains` string
          - `not-contains` string
        - `prompt_version` PartialTextOperators — Make all properties in T optional
          - `not-equals` string
          - `equals` string
          - `like` string
          - `ilike` string
          - `contains` string
          - `not-contains` string
        - `request_referrer` PartialTextOperators — Make all properties in T optional
          - `not-equals` string
          - `equals` string
          - `like` string
          - `ilike` string
          - `contains` string
          - `not-contains` string
        - `is_passthrough_billing` PartialBooleanOperators — Make all properties in T optional
          - `equals` boolean
    - EvalFilterBranch
      - `right` EvalFilterNode, required — recursive
      - `operator` 'or' | 'and', required
      - `left` EvalFilterNode, required — recursive
    - 'all'
  - `timeFilter` object, required
    - `end` string, required
    - `start` string, required
  - `offset` number, double
  - `limit` number, double
  - `timeZoneDifference` number, double

## Response `200`

Ok

- union
  - ResultSuccessEvalArray
    - `data` Eval[], required
      - `name` string, required
      - `averageScore` number, double, required
      - `minScore` number, double, required
      - `maxScore` number, double, required
      - `count` number, double, required
      - `overTime` object[], required
        - `count` number, double, required
        - `date` string, required
      - `averageOverTime` object[], required
        - `value` number, double, required
        - `date` string, 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)
