--- title: "POST /v1/session/query" method: POST path: "/v1/session/query" tags: ["Session"] --- # POST /v1/session/query `POST /v1/session/query` ## Request body - SessionQueryParams - `search` string, required - `timeFilter` object, required - `endTimeUnixMs` number, double, required - `startTimeUnixMs` number, double, required - `nameEquals` string - `timezoneDifference` number, double, required - `filter` union, required - FilterLeafSubsetRequestResponseRmtOrSessionsRequestResponseRmt — 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 - `sessions_request_response_rmt` PartialSessionsRequestResponseRMTToOperators — Make all properties in T optional - `session_session_id` PartialTextOperators — Make all properties in T optional - `not-equals` string - `equals` string - `like` string - `ilike` string - `contains` string - `not-contains` string - `session_session_name` PartialTextOperators — Make all properties in T optional - `not-equals` string - `equals` string - `like` string - `ilike` string - `contains` string - `not-contains` string - `session_total_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 - `session_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 - `session_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 - `session_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 - `session_total_requests` 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 - `session_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 - `session_latest_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 - `session_tag` PartialTextOperators — Make all properties in T optional - `not-equals` string - `equals` string - `like` string - `ilike` string - `contains` string - `not-contains` string - SessionFilterBranch - `right` SessionFilterNode, required — recursive - `operator` 'or' | 'and', required - `left` SessionFilterNode, required — recursive - 'all' - `offset` number, double - `limit` number, double ## Response `200` Ok - union - ResultSuccessSessionResultArray - `data` SessionResult[], required - `created_at` string, required - `latest_request_created_at` string, required - `session_id` string, required - `session_name` string, required - `total_cost` number, double, required - `total_requests` number, double, required - `prompt_tokens` number, double, required - `completion_tokens` number, double, required - `total_tokens` number, double, required - `avg_latency` number, double, required - `user_ids` 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)