curl --request GET \
--url https://api.nugen.in/api/v3/evaluations/list \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.nugen.in/api/v3/evaluations/list"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.nugen.in/api/v3/evaluations/list', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.nugen.in/api/v3/evaluations/list",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.nugen.in/api/v3/evaluations/list"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.nugen.in/api/v3/evaluations/list")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.nugen.in/api/v3/evaluations/list")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"user_id": "user-abc123",
"evaluations": [
{
"evaluation_id": "evaluation_01k4x9m2p7q3r7b1",
"status": "READY",
"created_at": "<string>",
"evaluation_name": "Support Bot v2 Eval"
}
],
"total": 5,
"limit": 10,
"offset": 0
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}List User Evaluations
Retrieve all evaluations for the authenticated user.
This endpoint returns a paginated list of lean evaluation rows. Fetch GET /evaluations/{evaluation_id} for the full record and /results for scores.
Query Parameters:
status(optional): Filter by evaluation status (QUEUED,PROCESSING,READY,FAILED)model_id(optional): Filter by specific model IDlimit(optional): Number of evaluations to return (1-100, default: 10)offset(optional): Number of evaluations to skip for pagination (default: 0)
Returns:
user_id: The authenticated user’s IDevaluations: List ofevaluation_id,evaluation_name,status,created_attotal: Total number of evaluations matching the filterslimit: Requested page sizeoffset: Current pagination offset
Example Request:
GET /api/v3/evaluations/list?status=READY&limit=5&offset=0
Headers: {"Authorization": "Bearer <api_key>"}
Example Response:
{
"user_id": "01KKBERWEEM634BQW9BK6Y0Y",
"evaluations": [
{
"evaluation_id": "eval_01KKJHBNFY9STH1C9",
"evaluation_name": "Support Bot v2 Eval",
"status": "READY",
"created_at": "2026-03-10T10:43:12.826791"
}
],
"total": 1,
"limit": 10,
"offset": 0
}
curl --request GET \
--url https://api.nugen.in/api/v3/evaluations/list \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.nugen.in/api/v3/evaluations/list"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.nugen.in/api/v3/evaluations/list', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.nugen.in/api/v3/evaluations/list",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.nugen.in/api/v3/evaluations/list"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.nugen.in/api/v3/evaluations/list")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.nugen.in/api/v3/evaluations/list")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"user_id": "user-abc123",
"evaluations": [
{
"evaluation_id": "evaluation_01k4x9m2p7q3r7b1",
"status": "READY",
"created_at": "<string>",
"evaluation_name": "Support Bot v2 Eval"
}
],
"total": 5,
"limit": 10,
"offset": 0
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Filter by evaluation status
Filter by model ID
Number of evaluations to return
1 <= x <= 100Number of evaluations to skip
x >= 0Response
Returns a list of all evaluations created by the user, with optional filtering by status or model ID. This endpoint allows users to retrieve their evaluation history, filter evaluations by status (e.g., PROCESSING, READY) or specific model, and supports pagination for easy navigation through large numbers of evaluations.
ID of the user
"user-abc123"
List of evaluations for the user
Show child attributes
Show child attributes
Total number of evaluations
5
Limit used for pagination
10
Offset used for pagination
0
Was this page helpful?