> ## Documentation Index > Fetch the complete documentation index at: https://docs.nugen.in/llms.txt > Use this file to discover all available pages before exploring further. # List User Evaluations > Retrieve all evaluations for the authenticated user. This endpoint returns a paginated list of all evaluations created by the user, with optional filtering by status or model ID. **Query Parameters:** - `status` (optional): Filter by evaluation status (`PROCESSING`, `READY`, `FAILED`) - `model_id` (optional): Filter by specific model ID - `limit` (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 ID - `evaluations`: List of evaluation objects - `total`: Total number of evaluations matching the filters - `limit`: Requested page size - `offset`: Current pagination offset **Example Request:** ```json GET /api/v3/evaluations?status=READY&limit=5&offset=0 Headers: {"Authorization": "Bearer "} ``` **Example Response:** ```json {"user_id":"01KKBERWEEM634BQW9BK6Y0Y", "evaluations": [{"evaluation_id":"eval_01KKJHBNFY9STH1C9", "model_id":"aligned-model-01kmqm4nrn9fw6r", "benchmark_id":"benchmark_01KKBN96Q34K8807Q", "status":"READY", "judge_provider":"nugen", "created_at":"2026-03-10T10:43:12.826791", "metrics": {"base_model": {"answer_relevance_max":1.0, "answer_relevance_min":1.0, "answer_relevance_std":0.0, "answer_relevance_mean":1.0, "binary_correctness_max":1.0, "binary_correctness_min":1.0, "binary_correctness_std":0.0, "binary_correctness_mean":1.0}, "eval_model": {"answer_relevance_max":1.0, "answer_relevance_min":1.0, "answer_relevance_std":0.0, "answer_relevance_mean":1.0, "binary_correctness_max":1.0, "binary_correctness_min":1.0, "binary_correctness_std":0.0, "binary_correctness_mean":1.0}, "comparison": {"metrics": [{"base":1.0,"metric":"binary_correctness_mean","evaluated":1.0,"improvement_%":0.0}, {"base":0.0,"metric":"binary_correctness_std","evaluated":0.0,"improvement_%":0}, {"base":1.0,"metric":"binary_correctness_min","evaluated":1.0,"improvement_%":0.0}, {"base":1.0,"metric":"binary_correctness_max","evaluated":1.0,"improvement_%":0.0}, {"base":1.0,"metric":"answer_relevance_mean","evaluated":1.0,"improvement_%":0.0}, {"base":0.0,"metric":"answer_relevance_std","evaluated":0.0,"improvement_%":0}, {"base":1.0,"metric":"answer_relevance_min","evaluated":1.0,"improvement_%":0.0}, {"base":1.0,"metric":"answer_relevance_max","evaluated":1.0,"improvement_%":0.0}], "summary":{"avg_improvement":0.0,"max_improvement":0.0,"min_improvement":0.0}}}}], "total":1,"limit":10,"offset":0} ``` ## OpenAPI ````yaml https://api.nugen.in/openapi-public.json get /api/v3/evaluations openapi: 3.1.0 info: title: Nugen Intelligence API description: 'Nugen Intelligence : Powering Specialized Intelligence At Scale' version: 25.4.20 servers: [] security: [] paths: /api/v3/evaluations: get: tags: - Evaluations summary: List User Evaluations description: >- Retrieve all evaluations for the authenticated user. This endpoint returns a paginated list of all evaluations created by the user, with optional filtering by status or model ID. **Query Parameters:** - `status` (optional): Filter by evaluation status (`PROCESSING`, `READY`, `FAILED`) - `model_id` (optional): Filter by specific model ID - `limit` (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 ID - `evaluations`: List of evaluation objects - `total`: Total number of evaluations matching the filters - `limit`: Requested page size - `offset`: Current pagination offset **Example Request:** ```json GET /api/v3/evaluations?status=READY&limit=5&offset=0 Headers: {"Authorization": "Bearer "} ``` **Example Response:** ```json {"user_id":"01KKBERWEEM634BQW9BK6Y0Y", "evaluations": [{"evaluation_id":"eval_01KKJHBNFY9STH1C9", "model_id":"aligned-model-01kmqm4nrn9fw6r", "benchmark_id":"benchmark_01KKBN96Q34K8807Q", "status":"READY", "judge_provider":"nugen", "created_at":"2026-03-10T10:43:12.826791", "metrics": {"base_model": {"answer_relevance_max":1.0, "answer_relevance_min":1.0, "answer_relevance_std":0.0, "answer_relevance_mean":1.0, "binary_correctness_max":1.0, "binary_correctness_min":1.0, "binary_correctness_std":0.0, "binary_correctness_mean":1.0}, "eval_model": {"answer_relevance_max":1.0, "answer_relevance_min":1.0, "answer_relevance_std":0.0, "answer_relevance_mean":1.0, "binary_correctness_max":1.0, "binary_correctness_min":1.0, "binary_correctness_std":0.0, "binary_correctness_mean":1.0}, "comparison": {"metrics": [{"base":1.0,"metric":"binary_correctness_mean","evaluated":1.0,"improvement_%":0.0}, {"base":0.0,"metric":"binary_correctness_std","evaluated":0.0,"improvement_%":0}, {"base":1.0,"metric":"binary_correctness_min","evaluated":1.0,"improvement_%":0.0}, {"base":1.0,"metric":"binary_correctness_max","evaluated":1.0,"improvement_%":0.0}, {"base":1.0,"metric":"answer_relevance_mean","evaluated":1.0,"improvement_%":0.0}, {"base":0.0,"metric":"answer_relevance_std","evaluated":0.0,"improvement_%":0}, {"base":1.0,"metric":"answer_relevance_min","evaluated":1.0,"improvement_%":0.0}, {"base":1.0,"metric":"answer_relevance_max","evaluated":1.0,"improvement_%":0.0}], "summary":{"avg_improvement":0.0,"max_improvement":0.0,"min_improvement":0.0}}}}], "total":1,"limit":10,"offset":0} ``` operationId: list_user_evaluations parameters: - name: status in: query required: false schema: anyOf: - type: string - type: 'null' description: Filter by evaluation status title: Status description: Filter by evaluation status - name: model_id in: query required: false schema: anyOf: - type: string - type: 'null' description: Filter by model ID title: Model Id description: Filter by model ID - name: limit in: query required: false schema: type: integer maximum: 100 minimum: 1 description: Number of evaluations to return default: 10 title: Limit description: Number of evaluations to return - name: offset in: query required: false schema: type: integer minimum: 0 description: Number of evaluations to skip default: 0 title: Offset description: Number of evaluations to skip responses: '200': description: >- 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. content: application/json: schema: $ref: '#/components/schemas/UserEvaluationsListResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - HTTPBearer: [] components: schemas: UserEvaluationsListResponse: properties: user_id: type: string title: User Id description: ID of the user example: user-abc123 evaluations: items: additionalProperties: true type: object type: array title: Evaluations description: List of evaluations for the user example: - evaluation_id: eval-abc123 model_id: model-xyz789 status: READY total: type: integer title: Total description: Total number of evaluations example: 5 limit: type: integer title: Limit description: Limit used for pagination example: 10 offset: type: integer title: Offset description: Offset used for pagination example: 0 type: object required: - user_id - evaluations - total - limit - offset title: UserEvaluationsListResponse HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: HTTPBearer: type: http scheme: bearer ````