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.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Nugen API Reference Docs","colors":{"primary":"#005b96","light":"#6497b1","dark":"#005b96"},"logo":{"light":"https://mintcdn.com/courteasy/YYugGl8ZAoQlnBYp/logo/light.svg?fit=max\u0026auto=format\u0026n=YYugGl8ZAoQlnBYp\u0026q=85\u0026s=f5f462b08161252f94dca4827e8055a0","dark":"https://mintcdn.com/courteasy/YYugGl8ZAoQlnBYp/logo/dark.svg?fit=max\u0026auto=format\u0026n=YYugGl8ZAoQlnBYp\u0026q=85\u0026s=c1f31d3028b6ad46f4c22208d402733e"},"favicon":"https://mintcdn.com/courteasy/YYugGl8ZAoQlnBYp/favicon.png?fit=max\u0026auto=format\u0026n=YYugGl8ZAoQlnBYp\u0026q=85\u0026s=74a9985970701685cc9f798a5bed86fe","api":{"openapi":"https://api.nugen.in/openapi-public.json","mdx":{"auth":{"method":"bearer"},"server":"https://api.nugen.in/"}},"navbar":{"links":[{"href":"https://github.com/nugen-in/nugen-cookbook","label":"Cookbook"}],"primary":{"type":"button","label":"Get API Key","href":"https://nugen.in/signup"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/nugen-in"}},"contextual":{"options":["copy","vscode","claude","chatgpt","perplexity","cursor"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"API Status","icon":"bolt-lightning","href":"https://status.nugen.in"},{"anchor":"Nugen Intelligence","icon":"earth-asia","href":"https://nugen.in"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"courteasy","hasAudioNarration":false,"actualSubdomain":"courteasy","customDomains":["docs.nugen.in"],"gitSource":{"type":"github","owner":"nugen-in","repo":"nugen-docs-test","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6ae488e3c69c99d3b7d10d90","clientVersion":"0.0.4102","searchFilterCounts":[{"language":"default","tag":"API Reference","count":43},{"language":"default","tag":"Models","count":10},{"language":"default","tag":"Alignment Projects","count":7},{"language":"default","tag":"Benchmarks","count":7},{"language":"default","tag":"Evaluations","count":6},{"language":"default","tag":"Documents","count":5},{"language":"default","tag":"Inference","count":5},{"language":"default","tag":"BYOC","count":2},{"language":"default","tag":"Health","count":1}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/evaluations/list-user-evaluations","slug":"/api-reference/evaluations/list-user-evaluations","pageMetadata":{"title":"List User Evaluations","description":"Retrieve all evaluations for the authenticated user.\n\nThis endpoint returns a paginated list of lean evaluation rows. Fetch `GET /evaluations/{evaluation_id}` for the full record and `/results` for scores.\n\n**Query Parameters:**\n\n- `status` (optional): Filter by evaluation status (`QUEUED`, `PROCESSING`, `READY`, `FAILED`)\n- `model_id` (optional): Filter by specific model ID\n- `limit` (optional): Number of evaluations to return (1-100, default: 10)\n- `offset` (optional): Number of evaluations to skip for pagination (default: 0)\n\n**Returns:**\n\n- `user_id`: The authenticated user's ID\n- `evaluations`: List of `evaluation_id`, `evaluation_name`, `status`, `created_at`\n- `total`: Total number of evaluations matching the filters\n- `limit`: Requested page size\n- `offset`: Current pagination offset\n\n**Example Request:**\n\n```json\nGET /api/v3/evaluations/list?status=READY\u0026limit=5\u0026offset=0\nHeaders: {\"Authorization\": \"Bearer \u003capi_key>\"}\n```\n\n**Example Response:**\n\n```json\n{\n \"user_id\": \"01KKBERWEEM634BQW9BK6Y0Y\",\n \"evaluations\": [\n {\n \"evaluation_id\": \"eval_01KKJHBNFY9STH1C9\",\n \"evaluation_name\": \"Clause Review v2 Eval\",\n \"status\": \"READY\",\n \"created_at\": \"2026-03-10T10:43:12.826791\",\n \"alignment_id\": \"alignment_01k4x9m2p7q3r8c1\"\n }\n ],\n \"total\": 1,\n \"limit\": 10,\n \"offset\": 0\n}\n```","deprecated":null,"version":null,"openapi":"https://api.nugen.in/openapi-public.json get /api/v3/evaluations/list","href":"/api-reference/evaluations/list-user-evaluations","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n li: \"li\",\n p: \"p\",\n pre: \"pre\",\n span: \"span\",\n strong: \"strong\",\n ul: \"ul\",\n ..._provideComponents(),\n ...props.components\n }, {CodeBlock} = _components;\n if (!CodeBlock) _missingMdxReference(\"CodeBlock\", true);\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Retrieve all evaluations for the authenticated user.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"This endpoint returns a paginated list of lean evaluation rows. Fetch \", _jsx(_components.code, {\n children: \"GET /evaluations/{evaluation_id}\"\n }), \" for the full record and \", _jsx(_components.code, {\n children: \"/results\"\n }), \" for scores.\"]\n }), \"\\n\", _jsx(_components.p, {\n children: _jsx(_components.strong, {\n children: \"Query Parameters:\"\n })\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"status\"\n }), \" (optional): Filter by evaluation status (\", _jsx(_components.code, {\n children: \"QUEUED\"\n }), \", \", _jsx(_components.code, {\n children: \"PROCESSING\"\n }), \", \", _jsx(_components.code, {\n children: \"READY\"\n }), \", \", _jsx(_components.code, {\n children: \"FAILED\"\n }), \")\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"model_id\"\n }), \" (optional): Filter by specific model ID\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"limit\"\n }), \" (optional): Number of evaluations to return (1-100, default: 10)\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"offset\"\n }), \" (optional): Number of evaluations to skip for pagination (default: 0)\"]\n }), \"\\n\"]\n }), \"\\n\", _jsx(_components.p, {\n children: _jsx(_components.strong, {\n children: \"Returns:\"\n })\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"user_id\"\n }), \": The authenticated user’s ID\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"evaluations\"\n }), \": List of \", _jsx(_components.code, {\n children: \"evaluation_id\"\n }), \", \", _jsx(_components.code, {\n children: \"evaluation_name\"\n }), \", \", _jsx(_components.code, {\n children: \"status\"\n }), \", \", _jsx(_components.code, {\n children: \"created_at\"\n })]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"total\"\n }), \": Total number of evaluations matching the filters\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"limit\"\n }), \": Requested page size\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"offset\"\n }), \": Current pagination offset\"]\n }), \"\\n\"]\n }), \"\\n\", _jsx(_components.p, {\n children: _jsx(_components.strong, {\n children: \"Example Request:\"\n })\n }), \"\\n\", _jsx(CodeBlock, {\n numberOfLines: \"2\",\n language: \"json\",\n children: _jsx(_components.pre, {\n className: \"shiki shiki-themes github-light-default dark-plus\",\n style: {\n backgroundColor: \"#ffffff\",\n \"--shiki-dark-bg\": \"#0B0C0E\",\n color: \"#1f2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n language: \"json\",\n children: _jsxs(_components.code, {\n language: \"json\",\n numberOfLines: \"2\",\n children: [_jsxs(_components.span, {\n className: \"line\",\n children: [_jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \"GET /api/v\"\n }), _jsx(_components.span, {\n style: {\n color: \"#0550AE\",\n \"--shiki-dark\": \"#B5CEA8\"\n },\n children: \"3\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \"/evaluations/list?status=READY\u0026limit=\"\n }), _jsx(_components.span, {\n style: {\n color: \"#0550AE\",\n \"--shiki-dark\": \"#B5CEA8\"\n },\n children: \"5\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \"\u0026offset=\"\n }), _jsx(_components.span, {\n style: {\n color: \"#0550AE\",\n \"--shiki-dark\": \"#B5CEA8\"\n },\n children: \"0\"\n })]\n }), \"\\n\", _jsxs(_components.span, {\n className: \"line\",\n children: [_jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \"Headers: {\"\n }), _jsx(_components.span, {\n style: {\n color: \"#116329\",\n \"--shiki-dark\": \"#9CDCFE\"\n },\n children: \"\\\"Authorization\\\"\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \": \"\n }), _jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#CE9178\"\n },\n children: \"\\\"Bearer \u003capi_key>\\\"\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \"}\"\n })]\n }), \"\\n\"]\n })\n })\n }), \"\\n\", _jsx(_components.p, {\n children: _jsx(_components.strong, {\n children: \"Example Response:\"\n })\n }), \"\\n\", _jsx(CodeBlock, {\n numberOfLines: \"15\",\n language: \"json\",\n children: _jsx(_components.pre, {\n className: \"shiki shiki-themes github-light-default dark-plus\",\n style: {\n backgroundColor: \"#ffffff\",\n \"--shiki-dark-bg\": \"#0B0C0E\",\n color: \"#1f2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n language: \"json\",\n children: _jsxs(_components.code, {\n language: \"json\",\n numberOfLines: \"15\",\n children: [_jsx(_components.span, {\n className: \"line\",\n children: _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \"{\"\n })\n }), \"\\n\", _jsxs(_components.span, {\n className: \"line\",\n children: [_jsx(_components.span, {\n style: {\n color: \"#116329\",\n \"--shiki-dark\": \"#9CDCFE\"\n },\n children: \" \\\"user_id\\\"\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \": \"\n }), _jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#CE9178\"\n },\n children: \"\\\"01KKBERWEEM634BQW9BK6Y0Y\\\"\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \",\"\n })]\n }), \"\\n\", _jsxs(_components.span, {\n className: \"line\",\n children: [_jsx(_components.span, {\n style: {\n color: \"#116329\",\n \"--shiki-dark\": \"#9CDCFE\"\n },\n children: \" \\\"evaluations\\\"\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \": [\"\n })]\n }), \"\\n\", _jsx(_components.span, {\n className: \"line\",\n children: _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \" {\"\n })\n }), \"\\n\", _jsxs(_components.span, {\n className: \"line\",\n children: [_jsx(_components.span, {\n style: {\n color: \"#116329\",\n \"--shiki-dark\": \"#9CDCFE\"\n },\n children: \" \\\"evaluation_id\\\"\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \": \"\n }), _jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#CE9178\"\n },\n children: \"\\\"eval_01KKJHBNFY9STH1C9\\\"\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \",\"\n })]\n }), \"\\n\", _jsxs(_components.span, {\n className: \"line\",\n children: [_jsx(_components.span, {\n style: {\n color: \"#116329\",\n \"--shiki-dark\": \"#9CDCFE\"\n },\n children: \" \\\"evaluation_name\\\"\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \": \"\n }), _jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#CE9178\"\n },\n children: \"\\\"Clause Review v2 Eval\\\"\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \",\"\n })]\n }), \"\\n\", _jsxs(_components.span, {\n className: \"line\",\n children: [_jsx(_components.span, {\n style: {\n color: \"#116329\",\n \"--shiki-dark\": \"#9CDCFE\"\n },\n children: \" \\\"status\\\"\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \": \"\n }), _jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#CE9178\"\n },\n children: \"\\\"READY\\\"\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \",\"\n })]\n }), \"\\n\", _jsxs(_components.span, {\n className: \"line\",\n children: [_jsx(_components.span, {\n style: {\n color: \"#116329\",\n \"--shiki-dark\": \"#9CDCFE\"\n },\n children: \" \\\"created_at\\\"\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \": \"\n }), _jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#CE9178\"\n },\n children: \"\\\"2026-03-10T10:43:12.826791\\\"\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \",\"\n })]\n }), \"\\n\", _jsxs(_components.span, {\n className: \"line\",\n children: [_jsx(_components.span, {\n style: {\n color: \"#116329\",\n \"--shiki-dark\": \"#9CDCFE\"\n },\n children: \" \\\"alignment_id\\\"\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \": \"\n }), _jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#CE9178\"\n },\n children: \"\\\"alignment_01k4x9m2p7q3r8c1\\\"\"\n })]\n }), \"\\n\", _jsx(_components.span, {\n className: \"line\",\n children: _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \" }\"\n })\n }), \"\\n\", _jsx(_components.span, {\n className: \"line\",\n children: _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \" ],\"\n })\n }), \"\\n\", _jsxs(_components.span, {\n className: \"line\",\n children: [_jsx(_components.span, {\n style: {\n color: \"#116329\",\n \"--shiki-dark\": \"#9CDCFE\"\n },\n children: \" \\\"total\\\"\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \": \"\n }), _jsx(_components.span, {\n style: {\n color: \"#0550AE\",\n \"--shiki-dark\": \"#B5CEA8\"\n },\n children: \"1\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \",\"\n })]\n }), \"\\n\", _jsxs(_components.span, {\n className: \"line\",\n children: [_jsx(_components.span, {\n style: {\n color: \"#116329\",\n \"--shiki-dark\": \"#9CDCFE\"\n },\n children: \" \\\"limit\\\"\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \": \"\n }), _jsx(_components.span, {\n style: {\n color: \"#0550AE\",\n \"--shiki-dark\": \"#B5CEA8\"\n },\n children: \"10\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \",\"\n })]\n }), \"\\n\", _jsxs(_components.span, {\n className: \"line\",\n children: [_jsx(_components.span, {\n style: {\n color: \"#116329\",\n \"--shiki-dark\": \"#9CDCFE\"\n },\n children: \" \\\"offset\\\"\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \": \"\n }), _jsx(_components.span, {\n style: {\n color: \"#0550AE\",\n \"--shiki-dark\": \"#B5CEA8\"\n },\n children: \"0\"\n })]\n }), \"\\n\", _jsx(_components.span, {\n className: \"line\",\n children: _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \"}\"\n })\n }), \"\\n\"]\n })\n })\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\nfunction _missingMdxReference(id, component) {\n throw new Error(\"Expected \" + (component ? \"component\" : \"object\") + \" `\" + id + \"` to be defined: you likely forgot to import, pass, or provide it.\");\n}\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"List User Evaluations","description":"Retrieve all evaluations for the authenticated user.\n\nThis endpoint returns a paginated list of lean evaluation rows. Fetch `GET /evaluations/{evaluation_id}` for the full record and `/results` for scores.\n\n**Query Parameters:**\n\n- `status` (optional): Filter by evaluation status (`QUEUED`, `PROCESSING`, `READY`, `FAILED`)\n- `model_id` (optional): Filter by specific model ID\n- `limit` (optional): Number of evaluations to return (1-100, default: 10)\n- `offset` (optional): Number of evaluations to skip for pagination (default: 0)\n\n**Returns:**\n\n- `user_id`: The authenticated user's ID\n- `evaluations`: List of `evaluation_id`, `evaluation_name`, `status`, `created_at`\n- `total`: Total number of evaluations matching the filters\n- `limit`: Requested page size\n- `offset`: Current pagination offset\n\n**Example Request:**\n\n```json\nGET /api/v3/evaluations/list?status=READY\u0026limit=5\u0026offset=0\nHeaders: {\"Authorization\": \"Bearer \u003capi_key>\"}\n```\n\n**Example Response:**\n\n```json\n{\n \"user_id\": \"01KKBERWEEM634BQW9BK6Y0Y\",\n \"evaluations\": [\n {\n \"evaluation_id\": \"eval_01KKJHBNFY9STH1C9\",\n \"evaluation_name\": \"Clause Review v2 Eval\",\n \"status\": \"READY\",\n \"created_at\": \"2026-03-10T10:43:12.826791\",\n \"alignment_id\": \"alignment_01k4x9m2p7q3r8c1\"\n }\n ],\n \"total\": 1,\n \"limit\": 10,\n \"offset\": 0\n}\n```","deprecated":null,"version":null,"openapi":"https://api.nugen.in/openapi-public.json get /api/v3/evaluations/list","href":"/api-reference/evaluations/list-user-evaluations","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Evaluations"],"summary":"List User Evaluations","description":"Retrieve all evaluations for the authenticated user.\n\nThis endpoint returns a paginated list of lean evaluation rows. Fetch `GET /evaluations/{evaluation_id}` for the full record and `/results` for scores.\n\n**Query Parameters:**\n\n- `status` (optional): Filter by evaluation status (`QUEUED`, `PROCESSING`, `READY`, `FAILED`)\n- `model_id` (optional): Filter by specific model ID\n- `limit` (optional): Number of evaluations to return (1-100, default: 10)\n- `offset` (optional): Number of evaluations to skip for pagination (default: 0)\n\n**Returns:**\n\n- `user_id`: The authenticated user's ID\n- `evaluations`: List of `evaluation_id`, `evaluation_name`, `status`, `created_at`\n- `total`: Total number of evaluations matching the filters\n- `limit`: Requested page size\n- `offset`: Current pagination offset\n\n**Example Request:**\n\n```json\nGET /api/v3/evaluations/list?status=READY\u0026limit=5\u0026offset=0\nHeaders: {\"Authorization\": \"Bearer \u003capi_key>\"}\n```\n\n**Example Response:**\n\n```json\n{\n \"user_id\": \"01KKBERWEEM634BQW9BK6Y0Y\",\n \"evaluations\": [\n {\n \"evaluation_id\": \"eval_01KKJHBNFY9STH1C9\",\n \"evaluation_name\": \"Clause Review v2 Eval\",\n \"status\": \"READY\",\n \"created_at\": \"2026-03-10T10:43:12.826791\",\n \"alignment_id\": \"alignment_01k4x9m2p7q3r8c1\"\n }\n ],\n \"total\": 1,\n \"limit\": 10,\n \"offset\": 0\n}\n```","operationId":"evaluations_list","security":["ef5f4e10-737b-4d45-80cd-8e2dbaf60617"],"parameters":["20a61718-fcdc-4732-b20e-0f8f661bac90","37a24ef2-97f9-44d1-a94b-b1400121a719","6be6f018-bade-49c6-bc59-c3068e6a470a","503a7dbf-439e-45cc-bec7-8c45f2e759fd"],"responses":{"200":"c508875d-c92e-4c1d-9b10-9212be6c7eee","401":"4626bf19-5e36-4077-9964-b3b7b5d8fd53","403":"4995cde1-316f-411e-ad13-04a687a1947a","422":"f3be54bd-7c96-4203-a119-4f757d3e0082"},"x-order":32,"method":"get","type":"path","servers":["446c7e81-4e2f-48c8-990b-adca5cc36d70"],"path":"/api/v3/evaluations/list","baseUrlOptions":["https://api.nugen.in"],"title":"List User Evaluations","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"20a61718-fcdc-4732-b20e-0f8f661bac90":{"name":"status","in":"query","required":false,"schema":{"oneOf":[{"type":"string","title":"Status","description":"Filter by evaluation status","uniqueKey":"oneOf.0","typeLabel":"string"},{"type":"null","title":"Status","description":"Filter by evaluation status","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"string | null"},"description":"Filter by evaluation status"},"37a24ef2-97f9-44d1-a94b-b1400121a719":{"name":"model_id","in":"query","required":false,"schema":{"oneOf":[{"type":"string","title":"Model Id","description":"Filter by model ID","uniqueKey":"oneOf.0","typeLabel":"string"},{"type":"null","title":"Model Id","description":"Filter by model ID","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"string | null"},"description":"Filter by model ID"},"6be6f018-bade-49c6-bc59-c3068e6a470a":{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Number of evaluations to return","default":10,"title":"Limit","isRequired":false,"uniqueKey":"","typeLabel":"integer"},"description":"Number of evaluations to return"},"503a7dbf-439e-45cc-bec7-8c45f2e759fd":{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Number of evaluations to skip","default":0,"title":"Offset","isRequired":false,"uniqueKey":"","typeLabel":"integer"},"description":"Number of evaluations to skip"}},"responses":{"c508875d-c92e-4c1d-9b10-9212be6c7eee":{"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":{"properties":{"user_id":{"type":"string","title":"User Id","description":"ID of the user","examples":["user-abc123"],"isRequired":true,"uniqueKey":"user_id","typeLabel":"string"},"evaluations":{"items":{"properties":{"evaluation_id":{"type":"string","title":"Evaluation Id","description":"Unique identifier of the evaluation.","examples":["evaluation_01k4x9m2p7q3r7b1"],"isRequired":true,"uniqueKey":"evaluations.items.[INDEX].evaluation_id","typeLabel":"string"},"status":{"type":"string","enum":["QUEUED","PROCESSING","READY","FAILED","STOPPED"],"title":"ResourceStatus","description":"Evaluation status: QUEUED, PROCESSING, READY or FAILED.","examples":["READY"],"isRequired":true,"uniqueKey":"evaluations.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Creation timestamp.","isRequired":true,"uniqueKey":"evaluations.items.[INDEX].created_at","typeLabel":"string\u003cdate-time>"},"evaluation_name":{"oneOf":[{"type":"string","title":"Evaluation Name","description":"Display name of the evaluation.","example":"Clause Review v2 Eval","uniqueKey":"evaluations.items.[INDEX].evaluation_name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Evaluation Name","description":"Display name of the evaluation.","example":"Clause Review v2 Eval","uniqueKey":"evaluations.items.[INDEX].evaluation_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"evaluations.items.[INDEX].evaluation_name","typeLabel":"string | null"},"alignment_id":{"oneOf":[{"type":"string","title":"Alignment Id","description":"Alignment project ID that produced the evaluated model. Null for base-model evaluations.","example":"alignment_01k4x9m2p7q3r8c1","uniqueKey":"evaluations.items.[INDEX].alignment_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Alignment Id","description":"Alignment project ID that produced the evaluated model. Null for base-model evaluations.","example":"alignment_01k4x9m2p7q3r8c1","uniqueKey":"evaluations.items.[INDEX].alignment_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"evaluations.items.[INDEX].alignment_id","typeLabel":"string | null"},"results":{"oneOf":[{"type":"object","title":"Results","description":"Null until READY. model_id and metrics are the evaluated model's own scores. baseline_model_id and baseline_metrics are set only in comparison mode. comparison.metrics_relative is each metric's delta, evaluated minus baseline.","example":{"baseline_metrics":{"binary_correctness_mean":0.85,"response_relevance_mean":0.8},"baseline_model_id":"model_01kabc456r","comparison":{"metrics_relative":{"binary_correctness_mean":0.07,"response_relevance_mean":0.08}},"metrics":{"binary_correctness_mean":0.92,"response_relevance_mean":0.88},"model_id":"model_01kmqm4nrn9fw6r"},"additionalProperties":true,"uniqueKey":"evaluations.items.[INDEX].results.oneOf.0","typeLabel":"Results · object"},{"type":"null","title":"Results","description":"Null until READY. model_id and metrics are the evaluated model's own scores. baseline_model_id and baseline_metrics are set only in comparison mode. comparison.metrics_relative is each metric's delta, evaluated minus baseline.","example":{"baseline_metrics":{"binary_correctness_mean":0.85,"response_relevance_mean":0.8},"baseline_model_id":"model_01kabc456r","comparison":{"metrics_relative":{"binary_correctness_mean":0.07,"response_relevance_mean":0.08}},"metrics":{"binary_correctness_mean":0.92,"response_relevance_mean":0.88},"model_id":"model_01kmqm4nrn9fw6r"},"uniqueKey":"evaluations.items.[INDEX].results.oneOf.1","typeLabel":"null"}],"uniqueKey":"evaluations.items.[INDEX].results","typeLabel":"Results · object | null"}},"type":"object","required":["evaluation_id","status","created_at"],"title":"EvaluationListItem","description":"A list row with its scores; the detail route carries the full record.","uniqueKey":"evaluations.items.[INDEX]","typeLabel":"EvaluationListItem · object"},"type":"array","title":"Evaluations","description":"List of evaluations for the user","isRequired":true,"uniqueKey":"evaluations","typeLabel":"EvaluationListItem · object[]"},"total":{"type":"integer","title":"Total","description":"Total number of evaluations","examples":[5],"isRequired":true,"uniqueKey":"total","typeLabel":"integer"},"limit":{"type":"integer","title":"Limit","description":"Limit used for pagination","examples":[10],"isRequired":true,"uniqueKey":"limit","typeLabel":"integer"},"offset":{"type":"integer","title":"Offset","description":"Offset used for pagination","examples":[0],"isRequired":true,"uniqueKey":"offset","typeLabel":"integer"}},"type":"object","required":["user_id","evaluations","total","limit","offset"],"title":"EvaluationListResponse","description":"The caller's evaluations.","uniqueKey":"","typeLabel":"EvaluationListResponse · object"},"examples":{"Example":{"title":"Example","value":{"user_id":"user-abc123","evaluations":[{"evaluation_id":"evaluation_01k4x9m2p7q3r7b1","status":"READY","created_at":"2023-11-07T05:31:56Z","evaluation_name":"Clause Review v2 Eval","alignment_id":"alignment_01k4x9m2p7q3r8c1","results":{"baseline_metrics":{"binary_correctness_mean":0.85,"response_relevance_mean":0.8},"baseline_model_id":"model_01kabc456r","comparison":{"metrics_relative":{"binary_correctness_mean":0.07,"response_relevance_mean":0.08}},"metrics":{"binary_correctness_mean":0.92,"response_relevance_mean":0.88},"model_id":"model_01kmqm4nrn9fw6r"}}],"total":5,"limit":10,"offset":0}}},"exampleType":"generated"}},"exampleType":"generated"},"4626bf19-5e36-4077-9964-b3b7b5d8fd53":{"description":"Invalid API key","content":{"application/json":{"schema":{"description":"Body of an error response.","properties":{"detail":{"oneOf":[{"type":"string","title":"Detail","description":"Human readable explanation of the error, or an object with a message and the id of the resource concerned","example":"Model not found","isRequired":true,"uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"object","title":"ErrorDetail","description":"Structured error detail: a message, with the id of the resource it concerns as an extra key.","required":["message"],"example":"Model not found","properties":{"message":{"description":"Human readable explanation of the error","title":"Message","type":"string","isRequired":true,"uniqueKey":"detail.oneOf.1.message","typeLabel":"string"}},"additionalProperties":true,"isRequired":true,"uniqueKey":"detail.oneOf.1","typeLabel":"ErrorDetail · object"}],"isRequired":true,"uniqueKey":"detail","typeLabel":"string | ErrorDetail · object"}},"required":["detail"],"title":"ErrorResponse","type":"object","uniqueKey":"","typeLabel":"ErrorResponse · object"},"examples":{"Example":{"title":"Example","value":{"detail":"Model not found"}}},"exampleType":"generated"}},"exampleType":"generated"},"4995cde1-316f-411e-ad13-04a687a1947a":{"description":"Authorization header missing or not a Bearer token","content":{"application/json":{"schema":{"description":"Body of an error response.","properties":{"detail":{"oneOf":[{"type":"string","title":"Detail","description":"Human readable explanation of the error, or an object with a message and the id of the resource concerned","example":"Model not found","isRequired":true,"uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"object","title":"ErrorDetail","description":"Structured error detail: a message, with the id of the resource it concerns as an extra key.","required":["message"],"example":"Model not found","properties":{"message":{"description":"Human readable explanation of the error","title":"Message","type":"string","isRequired":true,"uniqueKey":"detail.oneOf.1.message","typeLabel":"string"}},"additionalProperties":true,"isRequired":true,"uniqueKey":"detail.oneOf.1","typeLabel":"ErrorDetail · object"}],"isRequired":true,"uniqueKey":"detail","typeLabel":"string | ErrorDetail · object"}},"required":["detail"],"title":"ErrorResponse","type":"object","uniqueKey":"","typeLabel":"ErrorResponse · object"},"examples":{"Example":{"title":"Example","value":{"detail":"Model not found"}}},"exampleType":"generated"}},"exampleType":"generated"},"f3be54bd-7c96-4203-a119-4f757d3e0082":{"description":"Validation Error","content":{"application/json":{"schema":{"properties":{"detail":{"items":{"properties":{"loc":{"items":{"oneOf":[{"type":"string","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"detail.items.[INDEX].loc.items.[INDEX]","typeLabel":"string | integer"},"type":"array","title":"Location","isRequired":true,"uniqueKey":"detail.items.[INDEX].loc","typeLabel":"(string | integer)[]"},"msg":{"type":"string","title":"Message","isRequired":true,"uniqueKey":"detail.items.[INDEX].msg","typeLabel":"string"},"type":{"type":"string","title":"Error Type","isRequired":true,"uniqueKey":"detail.items.[INDEX].type","typeLabel":"string"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError","description":"One request validation problem.","uniqueKey":"detail.items.[INDEX]","typeLabel":"ValidationError · object"},"type":"array","title":"Detail","uniqueKey":"detail","typeLabel":"ValidationError · object[]"}},"type":"object","title":"HTTPValidationError","description":"Body of a request validation error.","uniqueKey":"","typeLabel":"HTTPValidationError · object"},"examples":{"Example":{"title":"Example","value":{"detail":[{"loc":["\u003cstring>"],"msg":"\u003cstring>","type":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"ef5f4e10-737b-4d45-80cd-8e2dbaf60617":{"ApiKeyAuth":{"type":"http","description":"Your Nugen API key, sent as a Bearer token","scheme":"bearer","bearerFormat":"API key","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"446c7e81-4e2f-48c8-990b-adca5cc36d70":{"url":"https://api.nugen.in","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","description":"Your Nugen API key, sent as a Bearer token","scheme":"bearer","bearerFormat":"API key","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Your Nugen API key, sent as a Bearer token","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"ApiKeyAuth","name":"Authorization"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"https://api.nugen.in/openapi-public.json"},"subdomain":"courteasy","siteName":"Nugen API Reference Docs","title":"List User Evaluations - Nugen API Reference Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-30T12:09:16.286Z","originalFileLocation":"api-reference/evaluations/list-user-evaluations.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"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 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\u0026#x27;s ID - evaluations: List of evaluation_id, evaluation_name, status, created_at - total: Total number of evaluations matching the filters - limit: Requested page size - offset: Current pagination offset Example Request: json GET /api/v3/evaluations/list?status=READY\u0026amp;limit=5\u0026amp;offset=0 Headers: {\u0026quot;Authorization\u0026quot;: \u0026quot;Bearer \u0026quot;} Example Response: json { \u0026quot;user_id\u0026quot;: \u0026quot;01KKBERWEEM634BQW9BK6Y0Y\u0026quot;, \u0026quot;evaluations\u0026quot;: [ { \u0026quot;evaluation_id\u0026quot;: \u0026quot;eval_01KKJHBNFY9STH1C9\u0026quot;, \u0026quot;evaluation_name\u0026quot;: \u0026quot;Clause Review v2 Eval\u0026quot;, \u0026quot;status\u0026quot;: \u0026quot;READY\u0026quot;, \u0026quot;created_at\u0026quot;: \u0026quot;2026-03-10T10:43:12.826791\u0026quot;, \u0026quot;alignment_id\u0026quot;: \u0026quot;alignment_01k4x9m2p7q3r8c1\u0026quot; } ], \u0026quot;total\u0026quot;: 1, \u0026quot;limit\u0026quot;: 10, \u0026quot;offset\u0026quot;: 0 }\">\u003cmeta data-mint-head name=\"application-name\" content=\"Nugen API Reference Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/courteasy/0D-fi3HjPY3grfJo/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/courteasy/0D-fi3HjPY3grfJo/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/courteasy/0D-fi3HjPY3grfJo/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/courteasy/0D-fi3HjPY3grfJo/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/courteasy/0D-fi3HjPY3grfJo/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/courteasy/0D-fi3HjPY3grfJo/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/courteasy/0D-fi3HjPY3grfJo/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/courteasy/0D-fi3HjPY3grfJo/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/courteasy/0D-fi3HjPY3grfJo/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"List User Evaluations - Nugen API Reference Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"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 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\u0026#x27;s ID - evaluations: List of evaluation_id, evaluation_name, status, created_at - total: Total number of evaluations matching the filters - limit: Requested page size - offset: Current pagination offset Example Request: json GET /api/v3/evaluations/list?status=READY\u0026amp;limit=5\u0026amp;offset=0 Headers: {\u0026quot;Authorization\u0026quot;: \u0026quot;Bearer \u0026quot;} Example Response: json { \u0026quot;user_id\u0026quot;: \u0026quot;01KKBERWEEM634BQW9BK6Y0Y\u0026quot;, \u0026quot;evaluations\u0026quot;: [ { \u0026quot;evaluation_id\u0026quot;: \u0026quot;eval_01KKJHBNFY9STH1C9\u0026quot;, \u0026quot;evaluation_name\u0026quot;: \u0026quot;Clause Review v2 Eval\u0026quot;, \u0026quot;status\u0026quot;: \u0026quot;READY\u0026quot;, \u0026quot;created_at\u0026quot;: \u0026quot;2026-03-10T10:43:12.826791\u0026quot;, \u0026quot;alignment_id\u0026quot;: \u0026quot;alignment_01k4x9m2p7q3r8c1\u0026quot; } ], \u0026quot;total\u0026quot;: 1, \u0026quot;limit\u0026quot;: 10, \u0026quot;offset\u0026quot;: 0 }\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Nugen API Reference Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.nugen.in/api-reference/evaluations/list-user-evaluations\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://courteasy.mintlify.site/_mintlify/api/og/v2?division=Evaluations\u0026amp;title=List+User+Evaluations\u0026amp;description=Retrieve+all+evaluations+for+the+authenticated+user.%0A%0AThis+endpoint+returns+a+paginated+list+of+lean+evaluation+rows.+Fetch+%60GET+%2Fevaluations%2F%7Bevaluation_id%7D%60+f\u0026amp;theme=4bbb9e0a87338e6afdf0d548\u0026amp;signature=3eb44c7ac4a3cfde3296c7cd9a8bf1916a8dd16f7e2216123ce0d57a43db35c8\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"List User Evaluations - Nugen API Reference Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"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 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\u0026#x27;s ID - evaluations: List of evaluation_id, evaluation_name, status, created_at - total: Total number of evaluations matching the filters - limit: Requested page size - offset: Current pagination offset Example Request: json GET /api/v3/evaluations/list?status=READY\u0026amp;limit=5\u0026amp;offset=0 Headers: {\u0026quot;Authorization\u0026quot;: \u0026quot;Bearer \u0026quot;} Example Response: json { \u0026quot;user_id\u0026quot;: \u0026quot;01KKBERWEEM634BQW9BK6Y0Y\u0026quot;, \u0026quot;evaluations\u0026quot;: [ { \u0026quot;evaluation_id\u0026quot;: \u0026quot;eval_01KKJHBNFY9STH1C9\u0026quot;, \u0026quot;evaluation_name\u0026quot;: \u0026quot;Clause Review v2 Eval\u0026quot;, \u0026quot;status\u0026quot;: \u0026quot;READY\u0026quot;, \u0026quot;created_at\u0026quot;: \u0026quot;2026-03-10T10:43:12.826791\u0026quot;, \u0026quot;alignment_id\u0026quot;: \u0026quot;alignment_01k4x9m2p7q3r8c1\u0026quot; } ], \u0026quot;total\u0026quot;: 1, \u0026quot;limit\u0026quot;: 10, \u0026quot;offset\u0026quot;: 0 }\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://courteasy.mintlify.site/_mintlify/api/og/v2?division=Evaluations\u0026amp;title=List+User+Evaluations\u0026amp;description=Retrieve+all+evaluations+for+the+authenticated+user.%0A%0AThis+endpoint+returns+a+paginated+list+of+lean+evaluation+rows.+Fetch+%60GET+%2Fevaluations%2F%7Bevaluation_id%7D%60+f\u0026amp;theme=4bbb9e0a87338e6afdf0d548\u0026amp;signature=3eb44c7ac4a3cfde3296c7cd9a8bf1916a8dd16f7e2216123ce0d57a43db35c8\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/courteasy/0D-fi3HjPY3grfJo/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Nugen API Reference Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#005b96\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.nugen.in/api-reference/evaluations/list-user-evaluations\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/evaluations/list-user-evaluations.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.nugen.in/#organization\",\"name\":\"Nugen API Reference Docs\",\"url\":\"https://docs.nugen.in\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/courteasy/YYugGl8ZAoQlnBYp/logo/light.svg?fit=max\u0026auto=format\u0026n=YYugGl8ZAoQlnBYp\u0026q=85\u0026s=f5f462b08161252f94dca4827e8055a0\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.nugen.in#website\",\"name\":\"Nugen API Reference Docs\",\"url\":\"https://docs.nugen.in\",\"publisher\":{\"@id\":\"https://docs.nugen.in/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.nugen.in/api-reference/evaluations/list-user-evaluations#webpage\",\"url\":\"https://docs.nugen.in/api-reference/evaluations/list-user-evaluations\",\"name\":\"List User Evaluations\",\"description\":\"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 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_id, evaluation_name, status, created_at - total: Total number of evaluations matching the filters - limit: Requested page size - offset: Current pagination offset Example Request: json GET /api/v3/evaluations/list?status=READY\u0026limit=5\u0026offset=0 Headers: {\\\"Authorization\\\": \\\"Bearer \\\"} Example Response: json { \\\"user_id\\\": \\\"01KKBERWEEM634BQW9BK6Y0Y\\\", \\\"evaluations\\\": [ { \\\"evaluation_id\\\": \\\"eval_01KKJHBNFY9STH1C9\\\", \\\"evaluation_name\\\": \\\"Clause Review v2 Eval\\\", \\\"status\\\": \\\"READY\\\", \\\"created_at\\\": \\\"2026-03-10T10:43:12.826791\\\", \\\"alignment_id\\\": \\\"alignment_01k4x9m2p7q3r8c1\\\" } ], \\\"total\\\": 1, \\\"limit\\\": 10, \\\"offset\\\": 0 }\",\"dateModified\":\"2026-10-30T12:09:16.286Z\",\"isPartOf\":{\"@id\":\"https://docs.nugen.in#website\"},\"breadcrumb\":{\"@id\":\"https://docs.nugen.in/api-reference/evaluations/list-user-evaluations#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.nugen.in/api-reference/evaluations/list-user-evaluations#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Evaluations\",\"item\":\"https://docs.nugen.in/api-reference/evaluations/create-evaluation\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"List User Evaluations\",\"item\":\"https://docs.nugen.in/api-reference/evaluations/list-user-evaluations\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.nugen.in/api-reference/evaluations/list-user-evaluations#apireference\",\"headline\":\"List User Evaluations\",\"name\":\"List User Evaluations\",\"description\":\"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 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_id, evaluation_name, status, created_at - total: Total number of evaluations matching the filters - limit: Requested page size - offset: Current pagination offset Example Request: json GET /api/v3/evaluations/list?status=READY\u0026limit=5\u0026offset=0 Headers: {\\\"Authorization\\\": \\\"Bearer \\\"} Example Response: json { \\\"user_id\\\": \\\"01KKBERWEEM634BQW9BK6Y0Y\\\", \\\"evaluations\\\": [ { \\\"evaluation_id\\\": \\\"eval_01KKJHBNFY9STH1C9\\\", \\\"evaluation_name\\\": \\\"Clause Review v2 Eval\\\", \\\"status\\\": \\\"READY\\\", \\\"created_at\\\": \\\"2026-03-10T10:43:12.826791\\\", \\\"alignment_id\\\": \\\"alignment_01k4x9m2p7q3r8c1\\\" } ], \\\"total\\\": 1, \\\"limit\\\": 10, \\\"offset\\\": 0 }\",\"url\":\"https://docs.nugen.in/api-reference/evaluations/list-user-evaluations\",\"mainEntityOfPage\":{\"@id\":\"https://docs.nugen.in/api-reference/evaluations/list-user-evaluations#webpage\"},\"dateModified\":\"2026-10-30T12:09:16.286Z\",\"publisher\":{\"@id\":\"https://docs.nugen.in/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.nugen.in#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Nugen API Reference Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Nugen API Reference Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/evaluations/list-user-evaluations.md","siteName":"Nugen API Reference Docs","nav":{"global":{"anchors":[{"anchor":"API Status","icon":"bolt-lightning","href":"https://status.nugen.in"},{"anchor":"Nugen Intelligence","icon":"earth-asia","href":"https://nugen.in"}]},"tabs":[{"tab":"API Reference","groups":[{"group":"Alignment Projects","pages":[{"title":"Create Alignment","deprecated":null,"version":null,"openapi":"https://api.nugen.in/openapi-public.json post /api/v3/alignment-projects/create","href":"/api-reference/alignment-projects/create-alignment"},{"title":"List Alignment Projects","deprecated":null,"version":null,"openapi":"https://api.nugen.in/openapi-public.json get /api/v3/alignment-projects/list","href":"/api-reference/alignment-projects/list-alignment-projects"},{"title":"Get Alignment Project","deprecated":null,"version":null,"openapi":"https://api.nugen.in/openapi-public.json get /api/v3/alignment-projects/{alignment_id}","href":"/api-reference/alignment-projects/get-alignment-project"},{"title":"Delete Alignment","deprecated":null,"version":null,"openapi":"https://api.nugen.in/openapi-public.json delete /api/v3/alignment-projects/{alignment_id}","href":"/api-reference/alignment-projects/delete-alignment"},{"title":"Get Alignment Status","deprecated":null,"version":null,"openapi":"https://api.nugen.in/openapi-public.json get /api/v3/alignment-projects/{alignment_id}/status","href":"/api-reference/alignment-projects/get-alignment-status"},{"title":"Stop Alignment","deprecated":null,"version":null,"openapi":"https://api.nugen.in/openapi-public.json post /api/v3/alignment-projects/{alignment_id}/stop","href":"/api-reference/alignment-projects/stop-alignment"},{"title":"Start Auto-Align","deprecated":null,"version":null,"openapi":"https://api.nugen.in/openapi-public.json post /api/v3/alignment-projects/{alignment_id}/auto-align","href":"/api-reference/alignment-projects/start-auto-align"}]},{"group":"Models","pages":[{"title":"List Base Models","deprecated":null,"version":null,"openapi":"https://api.nugen.in/openapi-public.json get /api/v3/models/base","href":"/api-reference/models/list-base-models"},{"title":"List Aligned Models","deprecated":null,"version":null,"openapi":"https://api.nugen.in/openapi-public.json get /api/v3/models/aligned","href":"/api-reference/models/list-aligned-models"},{"title":"Get Model","deprecated":null,"version":null,"openapi":"https://api.nugen.in/openapi-public.json get /api/v3/models/{model_id}","href":"/api-reference/models/get-model"},{"title":"Deploy Aligned Model","deprecated":null,"version":null,"openapi":"https://api.nugen.in/openapi-public.json post /api/v3/models/{model_id}/deployment","href":"/api-reference/models/deploy-aligned-model"},{"title":"Undeploy Model","deprecated":null,"version":null,"openapi":"https://api.nugen.in/openapi-public.json delete /api/v3/models/{model_id}/deployment","href":"/api-reference/models/undeploy-model"},{"title":"Get Deployment Status","deprecated":null,"version":null,"openapi":"https://api.nugen.in/openapi-public.json get /api/v3/models/{model_id}/deployment/status","href":"/api-reference/models/get-deployment-status"},{"title":"Refresh Deployed Model","deprecated":null,"version":null,"openapi":"https://api.nugen.in/openapi-public.json post /api/v3/models/{model_id}/deployment/refresh","href":"/api-reference/models/refresh-deployed-model"},{"title":"Export to Hugging Face","deprecated":null,"version":null,"openapi":"https://api.nugen.in/openapi-public.json post /api/v3/models/{model_id}/export-hf","href":"/api-reference/models/export-to-hugging-face"},{"title":"Import from Hugging Face","deprecated":null,"version":null,"openapi":"https://api.nugen.in/openapi-public.json post /api/v3/models/base/import","href":"/api-reference/models/import-from-hugging-face"},{"title":"Get the status of a Hugging Face export","deprecated":null,"version":null,"openapi":"https://api.nugen.in/openapi-public.json get /api/v3/models/{model_id}/export-hf/status","href":"/api-reference/models/get-the-status-of-a-hugging-face-export"}]},{"group":"Documents","pages":[{"title":"Upload Documents","deprecated":null,"version":null,"openapi":"https://api.nugen.in/openapi-public.json post /api/v3/documents/create","href":"/api-reference/documents/upload-documents"},{"title":"List Documents","deprecated":null,"version":null,"openapi":"https://api.nugen.in/openapi-public.json get /api/v3/documents/list","href":"/api-reference/documents/list-documents"},{"title":"Get Document Status","deprecated":null,"version":null,"openapi":"https://api.nugen.in/openapi-public.json get /api/v3/documents/{document_id}/status","href":"/api-reference/documents/get-document-status"},{"title":"Get Document","deprecated":null,"version":null,"openapi":"https://api.nugen.in/openapi-public.json get /api/v3/documents/{document_id}","href":"/api-reference/documents/get-document"},{"title":"Delete Document","deprecated":null,"version":null,"openapi":"https://api.nugen.in/openapi-public.json delete /api/v3/documents/{document_id}","href":"/api-reference/documents/delete-document"}]},{"group":"Benchmarks","pages":[{"title":"Create Benchmark","deprecated":null,"version":null,"openapi":"https://api.nugen.in/openapi-public.json post /api/v3/benchmarks/create","href":"/api-reference/benchmarks/create-benchmark"},{"title":"Upload Benchmark","deprecated":null,"version":null,"openapi":"https://api.nugen.in/openapi-public.json post /api/v3/benchmarks/upload","href":"/api-reference/benchmarks/upload-benchmark"},{"title":"List Benchmarks","deprecated":null,"version":null,"openapi":"https://api.nugen.in/openapi-public.json get /api/v3/benchmarks/list","href":"/api-reference/benchmarks/list-benchmarks"},{"title":"Get Benchmark","deprecated":null,"version":null,"openapi":"https://api.nugen.in/openapi-public.json get /api/v3/benchmarks/{benchmark_id}","href":"/api-reference/benchmarks/get-benchmark"},{"title":"Delete Benchmark","deprecated":null,"version":null,"openapi":"https://api.nugen.in/openapi-public.json delete /api/v3/benchmarks/{benchmark_id}","href":"/api-reference/benchmarks/delete-benchmark"},{"title":"Get Benchmark Status","deprecated":null,"version":null,"openapi":"https://api.nugen.in/openapi-public.json get /api/v3/benchmarks/{benchmark_id}/status","href":"/api-reference/benchmarks/get-benchmark-status"},{"title":"Get Generated Benchmark","deprecated":null,"version":null,"openapi":"https://api.nugen.in/openapi-public.json get /api/v3/benchmarks/{benchmark_id}/data","href":"/api-reference/benchmarks/get-generated-benchmark"}]},{"group":"Evaluations","pages":[{"title":"Create Evaluation","description":"Create a new model evaluation using an existing benchmark.\n\nThis endpoint initiates a model evaluation using a benchmark from your library. Supports both single model evaluation and comparison mode where two models are evaluated side-by-side.\n\n**Request Body:**\n\n- `model_id`: Primary model to evaluate (required). It need not be deployed. A deployed model answers within seconds. An undeployed one is loaded by the GPU on demand and its answers wait for the next batch cycle, about 5 minutes.\n- `benchmark_id`: ID of the benchmark to use for evaluation (required)\n- `baseline_model_id` (optional): Baseline model ID for comparison mode\n- `custom_metrics` (optional): `defaults`, the built-in metrics to run (`binary_correctness`, `response_relevance`; both run when omitted), and `custom`, up to 5 metrics of your own, each with `name`, `prompt`, `parse_json`, `score_min` and `score_max`. A custom `name` cannot reuse a built-in name. Each custom metric adds one judge call per question, so it adds time and cost. An invalid configuration is refused with 422\n- `evaluation_name` (optional): Display name. Defaults to the evaluation id if omitted\n\n**Returns:**\n\n- `evaluation_id`: Unique identifier for tracking the evaluation\n- `model_id`: The primary model being evaluated\n- `status`: Initial status (always `PROCESSING`)\n- `benchmark_id`: The benchmark being used\n- `created_at`: Timestamp when evaluation was created\n- `message`: Confirmation message\n\n**Example Request (Single Model):**\n\n```json\nPOST /api/v3/evaluations/create\nHeaders: {\"Authorization\": \"Bearer \u003capi_key>\"}\n\n{\n \"model_id\": \"model_01kmqm4nrn9fw6r\",\n \"benchmark_id\": \"benchmark_01k4x9m2p7q3r6a1\",\n \"custom_metrics\": {\n \"defaults\": [\"binary_correctness\", \"response_relevance\"],\n \"custom\": [\n {\n \"name\": \"hallucination_check\",\n \"prompt\": \"Does the generated answer contain factually incorrect information? Rate from 0-1.\",\n \"score_min\": 0.0,\n \"score_max\": 1.0\n }\n ]\n }\n}\n```\n\n**Example Request (Comparison Mode):**\n\n```json\nPOST /api/v3/evaluations/create\nHeaders: {\"Authorization\": \"Bearer \u003capi_key>\"}\n\n{\n \"model_id\": \"Qwen/Qwen2.5-0.5B-Instruct\",\n \"baseline_model_id\": \"model_01kmqm4nrn9fw6r\",\n \"benchmark_id\": \"benchmark_01k4x9m2p7q3r6a1\"\n}\n```\n\n**Example Response:**\n\n```json\n{\n \"evaluation_id\": \"evaluation_01k4x9m2p7q3r7b1\",\n \"model_id\": \"model_01kmqm4nrn9fw6r\",\n \"status\": \"PROCESSING\",\n \"benchmark_id\": \"benchmark_01k4x9m2p7q3r6a1\",\n \"created_at\": \"2024-01-15T10:30:00Z\",\n \"message\": \"Evaluation created successfully and queued for execution\"\n}\n```\n**Notes:**\n\n- Single model mode: Evaluates one model against the benchmark\n- Comparison mode: Provide `baseline_model_id` to compare two models side-by-side\n- Evaluation runs asynchronously - use the returned `evaluation_id` to check status\n- Each metric reports `\u003cname>_mean`, `_min`, `_max`, `_std` and `_valid_count` in the results, custom ones included. A `_valid_count` of 0 means the judge gave no usable score for that metric. Comparison mode adds the mean difference for custom metrics\n- Use `/evaluations/{evaluation_id}/status` to track progress","deprecated":null,"version":null,"openapi":"https://api.nugen.in/openapi-public.json post /api/v3/evaluations/create","href":"/api-reference/evaluations/create-evaluation"},{"title":"List User Evaluations","deprecated":null,"version":null,"openapi":"https://api.nugen.in/openapi-public.json get /api/v3/evaluations/list","href":"/api-reference/evaluations/list-user-evaluations"},{"title":"Get Evaluation","description":"Get one evaluation by ID.\n\n**Returns:**\n\n- `evaluation_id`, `status` (`QUEUED`, `PROCESSING`, `READY`, `FAILED`)\n- `model_id`, `benchmark_id`, `progress`\n- `n_samples_completed`, `n_samples`, `avg_time_per_sample`, `eta_seconds`\n- `created_at`, `completed_at`, `updated_at`","deprecated":null,"version":null,"openapi":"https://api.nugen.in/openapi-public.json get /api/v3/evaluations/{evaluation_id}","href":"/api-reference/evaluations/get-evaluation"},{"title":"Delete Evaluation","deprecated":null,"version":null,"openapi":"https://api.nugen.in/openapi-public.json delete /api/v3/evaluations/{evaluation_id}","href":"/api-reference/evaluations/delete-evaluation"},{"title":"Get Evaluation Status","deprecated":null,"version":null,"openapi":"https://api.nugen.in/openapi-public.json get /api/v3/evaluations/{evaluation_id}/status","href":"/api-reference/evaluations/get-evaluation-status"},{"title":"Get Evaluation Results","deprecated":null,"version":null,"openapi":"https://api.nugen.in/openapi-public.json get /api/v3/evaluations/{evaluation_id}/results","href":"/api-reference/evaluations/get-evaluation-results"}]},{"group":"Inference","pages":[{"title":"Generate Embeddings","deprecated":null,"version":null,"openapi":"https://api.nugen.in/openapi-public.json post /api/v3/inference/embeddings","href":"/api-reference/inference/generate-embeddings"},{"title":"Generate Chat Completions","deprecated":null,"version":null,"openapi":"https://api.nugen.in/openapi-public.json post /api/v3/inference/chat/completions","href":"/api-reference/inference/generate-chat-completions"},{"title":"OpenAI-compatible Responses","deprecated":null,"version":null,"openapi":"https://api.nugen.in/openapi-public.json post /api/v3/inference/responses","href":"/api-reference/inference/openai-compatible-responses"},{"title":"Rerank Documents","deprecated":null,"version":null,"openapi":"https://api.nugen.in/openapi-public.json post /api/v3/inference/reranker","href":"/api-reference/inference/rerank-documents"},{"title":"Inference Settings","deprecated":null,"version":null,"openapi":"https://api.nugen.in/openapi-public.json get /api/v3/inference/capture","href":"/api-reference/inference/inference-settings"}]},{"group":"BYOC","pages":[{"title":"Deploy in your own cloud or cluster","deprecated":null,"version":null,"openapi":"https://api.nugen.in/openapi-public.json post /api/v3/byoc/clusters","href":"/api-reference/byoc/deploy-in-your-own-cloud-or-cluster"},{"title":"Get Cluster Health","deprecated":null,"version":null,"openapi":"https://api.nugen.in/openapi-public.json get /api/v3/byoc/clusters/{cluster_id}/status","href":"/api-reference/byoc/get-cluster-health"}]},{"group":"Health","pages":[{"title":"API Health","deprecated":null,"version":null,"openapi":"https://api.nugen.in/openapi-public.json get /health","href":"/api-reference/health/api-health"}]}]}]},"basePath":"","title":"List User Evaluations - Nugen API Reference Docs","buildId":"dpl_596ePT575z4qnAFksq1biRW97aLY","deploymentId":"dpl_596ePT575z4qnAFksq1biRW97aLY","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C9Wu0MeN.js","utils-jWgu-6Qf.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DBD8f9qn.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BGuX1ui5.js","snippetPresets-Evy63nQB.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BQHO1lnV.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-B6C8m-t_.js","shallow-BG4cT0fH.js","getApiPlaygroundDisplay-CgEPrE-D.js","CodeSnippet-CU8JyZ9N.js","CodeSnippets-BnxHU32T.js","Page-D6S0Yh6q.js","getPastedJson-CwiYOonh.js","icon-DYDpWmDf.js","MethodPill-C-J-l7_c.js","DuplicateIcon-B6ARwg9w.js","createIcon-Dsv4MtDq.js","DynamicMarkdown-CtasenyM.js","SectionHeading-YNcgYwjB.js","axios-vUo_bRtp.js","Markdown-CwLx6PAg.js","clsx-C3kuh_dz.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CmKHfscc.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-U3mI6Ljh.js"]}