Skip to main content
Helicone OSS LLM Observability

Get Requests (Point Queries)

Retrieve all requests visible in the request table at Helicone.
1 min read
post/v1/request/query
Request example
Response
post/v1/request/query
Warning

For users in the European Union: Please use eu.api.helicone.ai instead of api.helicone.ai.

Warning

This API is optimized for point queries. For bulk queries, use the Get Requests (faster) API.

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

Premade examples 👇#

FilterDescription
Get Request by UserGet 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:

This allows us to build complex filters like this:

Authorization

Authorizationstringheaderrequired#
Bearer token authentication. Format: 'Bearer YOUR_API_KEY'

Body

application/json
filterobject · enum<string>required#
Show child attributes
offsetnumber#
limitnumber#
sortobject#
Show child attributes
randomenum<boolean>#
Options:true
created_atenum<string>#
Options:ascdesc
cache_created_atenum<string>#
Options:ascdesc
latencyenum<string>#
Options:ascdesc
last_activeenum<string>#
Options:ascdesc
total_tokensenum<string>#
Options:ascdesc
completion_tokensenum<string>#
Options:ascdesc
prompt_tokensenum<string>#
Options:ascdesc
user_idenum<string>#
Options:ascdesc
body_modelenum<string>#
Options:ascdesc
is_cachedenum<string>#
Options:ascdesc
request_promptenum<string>#
Options:ascdesc
response_textenum<string>#
Options:ascdesc
propertiesobject#
Show child attributes
{key}enum<string>#
Options:ascdesc
valuesobject#
Show child attributes
{key}enum<string>#
Options:ascdesc
costenum<string>#
Options:ascdesc
time_to_first_tokenenum<string>#
Options:ascdesc
isCachedboolean#
includeInputsboolean#
isPartOfExperimentboolean#
isScoredboolean#

Responses

application/json
200
Ok