Warning
For users in the European Union: Please use eu.api.helicone.ai instead of
api.helicone.ai.
Query Evaluations
Search and filter through evaluation results
1 min read
post/v1/evals/query
Request example
curl --request POST \
--url https://api.helicone.ai/v1/evals/query \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"filter": {
"request_response_rmt": {
"country_code": {
"not-equals": "<string>",
"equals": "<string>",
"like": "<string>",
"ilike": "<string>",
"contains": "<string>",
"not-contains": "<string>"
},
"latency": {
"not-equals": 1,
"equals": 1,
"gte": 1,
"lte": 1,
"lt": 1,
"gt": 1
},
"cost": {
"not-equals": 1,
"equals": 1,
"gte": 1,
"lte": 1,
"lt": 1,
"gt": 1
},
"provider": {
"not-equals": "<string>",
"equals": "<string>",
"like": "<string>",
"ilike": "<string>",
"contains": "<string>",
"not-contains": "<string>"
},
"time_to_first_token": {
"not-equals": 1,
"equals": 1,
"gte": 1,
"lte": 1,
"lt": 1,
"gt": 1
},
"status": {
"not-equals": 1,
"equals": 1,
"gte": 1,
"lte": 1,
"lt": 1,
"gt": 1
},
"request_created_at": {
"equals": "2026-08-10T12:00:00Z",
"gte": "2026-08-10T12:00:00Z",
"lte": "2026-08-10T12:00:00Z",
"lt": "2026-08-10T12:00:00Z",
"gt": "2026-08-10T12:00:00Z"
},
"response_created_at": {
"equals": "2026-08-10T12:00:00Z",
"gte": "2026-08-10T12:00:00Z",
"lte": "2026-08-10T12:00:00Z",
"lt": "2026-08-10T12:00:00Z",
"gt": "2026-08-10T12:00:00Z"
},
"model": {
"not-equals": "<string>",
"equals": "<string>",
"like": "<string>",
"ilike": "<string>",
"contains": "<string>",
"not-contains": "<string>"
},
"user_id": {
"not-equals": "<string>",
"equals": "<string>",
"like": "<string>",
"ilike": "<string>",
"contains": "<string>",
"not-contains": "<string>"
},
"organization_id": {
"not-equals": "<string>",
"equals": "<string>",
"like": "<string>",
"ilike": "<string>",
"contains": "<string>",
"not-contains": "<string>"
},
"node_id": {
"not-equals": "<string>",
"equals": "<string>",
"like": "<string>",
"ilike": "<string>",
"contains": "<string>",
"not-contains": "<string>"
},
"job_id": {
"not-equals": "<string>",
"equals": "<string>",
"like": "<string>",
"ilike": "<string>",
"contains": "<string>",
"not-contains": "<string>"
},
"threat": {
"equals": true
},
"request_id": {
"not-equals": "<string>",
"equals": "<string>",
"like": "<string>",
"ilike": "<string>",
"contains": "<string>",
"not-contains": "<string>"
},
"prompt_tokens": {
"not-equals": 1,
"equals": 1,
"gte": 1,
"lte": 1,
"lt": 1,
"gt": 1
},
"completion_tokens": {
"not-equals": 1,
"equals": 1,
"gte": 1,
"lte": 1,
"lt": 1,
"gt": 1
},
"prompt_cache_read_tokens": {
"not-equals": 1,
"equals": 1,
"gte": 1,
"lte": 1,
"lt": 1,
"gt": 1
},
"prompt_cache_write_tokens": {
"not-equals": 1,
"equals": 1,
"gte": 1,
"lte": 1,
"lt": 1,
"gt": 1
},
"total_tokens": {
"not-equals": 1,
"equals": 1,
"gte": 1,
"lte": 1,
"lt": 1,
"gt": 1
},
"target_url": {
"not-equals": "<string>",
"equals": "<string>",
"like": "<string>",
"ilike": "<string>",
"contains": "<string>",
"not-contains": "<string>"
},
"property_key": {
"equals": "<string>"
},
"properties": {},
"search_properties": {},
"scores": {},
"scores_column": {
"not-equals": "<string>",
"equals": "<string>",
"like": "<string>",
"ilike": "<string>",
"contains": "<string>",
"not-contains": "<string>"
},
"request_body": {
"not-equals": "<string>",
"equals": "<string>",
"like": "<string>",
"ilike": "<string>",
"contains": "<string>",
"not-contains": "<string>"
},
"response_body": {
"not-equals": "<string>",
"equals": "<string>",
"like": "<string>",
"ilike": "<string>",
"contains": "<string>",
"not-contains": "<string>"
},
"cache_enabled": {
"equals": true
},
"cache_reference_id": {
"not-equals": "<string>",
"equals": "<string>",
"like": "<string>",
"ilike": "<string>",
"contains": "<string>",
"not-contains": "<string>"
},
"cached": {
"equals": true
},
"assets": {
"not-equals": "<string>",
"equals": "<string>",
"like": "<string>",
"ilike": "<string>",
"contains": "<string>",
"not-contains": "<string>"
},
"helicone-score-feedback": {
"equals": true
},
"prompt_id": {
"not-equals": "<string>",
"equals": "<string>",
"like": "<string>",
"ilike": "<string>",
"contains": "<string>",
"not-contains": "<string>"
},
"prompt_version": {
"not-equals": "<string>",
"equals": "<string>",
"like": "<string>",
"ilike": "<string>",
"contains": "<string>",
"not-contains": "<string>"
},
"request_referrer": {
"not-equals": "<string>",
"equals": "<string>",
"like": "<string>",
"ilike": "<string>",
"contains": "<string>",
"not-contains": "<string>"
},
"is_passthrough_billing": {
"equals": true
}
}
},
"timeFilter": {
"end": "<string>",
"start": "<string>"
},
"offset": 1,
"limit": 1,
"timeZoneDifference": 1
}'Response
{
"data": [
{
"name": "<string>",
"averageScore": 1,
"minScore": 1,
"maxScore": 1,
"count": 1,
"overTime": [
{
"count": 1,
"date": "<string>"
}
],
"averageOverTime": [
{
"value": 1,
"date": "<string>"
}
]
}
],
"error": null
}post/v1/evals/query
Authorization
Bearer token authentication. Format: 'Bearer YOUR_API_KEY'
Body
application/jsonResponses
application/json
200
Ok