Skip to main content
GET
Get evaluation results

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

retriever_id
string
required
evaluation_id
string
required

Response

Successful Response

Complete evaluation record with results.

evaluation_id
string
required

Unique evaluation identifier

retriever_id
string
required

ID of retriever being evaluated

dataset_id
string
required

ID of dataset used for evaluation

dataset_name
string
required

Name of dataset

config
EvaluationConfig · object
required

Evaluation configuration

status
enum<string>
required

Current status

Available options:
pending,
in_progress,
completed,
failed
created_at
string<date-time>
required

When evaluation was created

updated_at
string<date-time>
required

Last update timestamp

namespace_id
string
required

Namespace ID

internal_id
string
required

Internal organization ID

query_count
integer
required

Number of queries evaluated

completed_at
string<date-time> | null

When evaluation completed

overall_metrics
Overall Metrics · object | null

Aggregated metrics across all queries

metrics_by_k
Metrics By K · object | null

Metrics broken down by K value (keys are string K values like '5', '10', '20')

total_queries
integer | null

Total queries in the dataset for this run (= evaluated_queries + skipped_queries).

evaluated_queries
integer | null

Number of queries that produced metrics. May be < total_queries when some queries were skipped (skip-and-continue on empty/failing input).

skipped_queries
integer | null

Number of queries skipped during evaluation (empty query_input or a per-query execution failure) — these did not fail the whole eval.

error_message
string | null

Error message if failed