Get Requests

POST

request

query

object

filter

Option 1 · object

request_response_rmt

object

latency

object

not-equals

number

equals

number

gte

number

lte

number

status

object

not-equals

number

equals

number

gte

number

lte

number

request_created_at

object

gte

string

lte

string

response_created_at

object

gte

string

lte

string

model

object

not-equals

string

equals

string

ilike

string

contains

string

not-contains

string

user_id

object

not-equals

string

equals

string

ilike

string

contains

string

not-contains

string

organization_id

object

not-equals

string

equals

string

ilike

string

contains

string

not-contains

string

node_id

object

not-equals

string

equals

string

ilike

string

contains

string

not-contains

string

job_id

object

not-equals

string

equals

string

ilike

string

contains

string

not-contains

string

threat

object

equals

boolean

request_id

object

not-equals

string

equals

string

ilike

string

contains

string

not-contains

string

prompt_tokens

object

not-equals

number

equals

number

gte

number

lte

number

completion_tokens

object

not-equals

number

equals

number

gte

number

lte

number

total_tokens

object

not-equals

number

equals

number

gte

number

lte

number

target_url

object

not-equals

string

equals

string

ilike

string

contains

string

not-contains

string

properties

object

search_properties

object

scores

object

scores_column

object

not-equals

string

equals

string

ilike

string

contains

string

not-contains

string

request_body

object

contains

string

response_body

object

contains

string

response

object

body_tokens

object

not-equals

number

equals

number

gte

number

lte

number

body_model

object

not-equals

string

equals

string

ilike

string

contains

string

not-contains

string

body_completion

object

not-equals

string

equals

string

ilike

string

contains

string

not-contains

string

status

object

not-equals

number

equals

number

gte

number

lte

number

model

object

not-equals

string

equals

string

ilike

string

contains

string

not-contains

string

request

object

prompt

object

not-equals

string

equals

string

ilike

string

contains

string

not-contains

string

created_at

object

gte

string

lte

string

user_id

object

not-equals

string

equals

string

ilike

string

contains

string

not-contains

string

auth_hash

object

not-equals

string

equals

string

ilike

string

contains

string

not-contains

string

org_id

object

not-equals

string

equals

string

ilike

string

contains

string

not-contains

string

object

not-equals

string

equals

string

ilike

string

contains

string

not-contains

string

node_id

object

not-equals

string

equals

string

ilike

string

contains

string

not-contains

string

model

object

not-equals

string

equals

string

ilike

string

contains

string

not-contains

string

modelOverride

object

not-equals

string

equals

string

ilike

string

contains

string

not-contains

string

path

object

not-equals

string

equals

string

ilike

string

contains

string

not-contains

string

prompt_id

object

not-equals

string

equals

string

ilike

string

contains

string

not-contains

string

feedback

object

not-equals

number

equals

number

gte

number

lte

number

created_at

object

gte

string

lte

string

rating

object

equals

boolean

response_id

object

not-equals

string

equals

string

ilike

string

contains

string

not-contains

string

request_response_search

object

request_body_vector

object

contains

string

response_body_vector

object

contains

string

sessions_request_response_rmt

object

total_cost

object

not-equals

number

equals

number

gte

number

lte

number

total_tokens

object

not-equals

number

equals

number

gte

number

lte

number

cache_hits

object

organization_id

object

not-equals

string

equals

string

ilike

string

contains

string

not-contains

string

request_id

object

not-equals

string

equals

string

ilike

string

contains

string

not-contains

string

latency

object

not-equals

number

equals

number

gte

number

lte

number

completion_tokens

object

not-equals

number

equals

number

gte

number

lte

number

prompt_tokens

object

not-equals

number

equals

number

gte

number

lte

number

created_at

object

gte

string

lte

string

properties

object

values

object

offset

number

limit

number

sort

object

random

boolean

created_at

enum<string>

cache_created_at

enum<string>

latency

enum<string>

last_active

enum<string>

total_tokens

enum<string>

completion_tokens

enum<string>

prompt_tokens

enum<string>

user_id

enum<string>

body_model

enum<string>

is_cached

enum<string>

request_prompt

enum<string>

response_text

enum<string>

properties

object

values

object

isCached

boolean

includeInputs

boolean

isPartOfExperiment

boolean

isScored

boolean

The following API lets you get all of the requests that would be visible in the request table at helicone.ai/requests.

Premade examples 👇

Filter	Description
Get Request by User	Get all the requests made by a user

Filter

A filter is either a FilterLeaf or a FilterBranch, and can be composed of multiple filters generating an AST of ANDs/ORs.

Here is how it is represented in typescript:

export interface FilterBranch {
  left: FilterNode;
  operator: "or" | "and"; // Can add more later
  right: FilterNode;
}

export type FilterNode = FilterLeaf | FilterBranch | "all";

This allows us to build complex filters like this:

{
  "filter": {
    "operator": "and",
    "right": {
      "request": {
        "model": {
          "contains": "gpt-4"
        }
      }
    },
    "left": {
      "request": {
        "user_id": {
          "equals": "abc@email.com"
        }
      }
    }
  }
}

Authorizations

authorization

string

headerrequired

Body

application/json

Request query filters

filter

required

From T, pick a set of properties whose keys are in the union K

offset

number

limit

number

sort

object

isCached

boolean

includeInputs

boolean

isPartOfExperiment

boolean

isScored

boolean

Response

200 - application/json

data

object[]

required

error

enum<number> | null

required

Was this page helpful?

Get User Metrics Submit Feedback

User

Request

Prompt

Dataset

Experiment

Customer

Premade examples 👇

Filter

Authorizations

Body

Response

User

Request

Prompt

Dataset

Experiment

Customer

​Premade examples 👇

​Filter

Authorizations

Body

Response

Premade examples 👇

Filter