Get Eval Run Suite Report
Get a specific eval run suite report by UUID.
Path parameters
-
report_uuid
string Required
Query parameters
-
workspace_uuid
string
Responses
-
200 application/json
OK
-
400 application/json
Bad Request
-
401 application/json
Unauthorized
-
403 application/json
Forbidden
-
404 application/json
Not Found
-
409 application/json
Conflict
-
422 application/json
Unprocessable Entity
-
429 application/json
Too Many Requests
-
500 application/json
Internal Server Error
-
503 application/json
Service Unavailable
GET
/v2/eval-reports/{report_uuid}
Python
import os
from aymara_ai import AymaraAI
client = AymaraAI(
api_key=os.environ.get("AYMARA_AI_API_KEY"), # This is the default and can be omitted
)
eval_suite_report = client.reports.get(
report_uuid="report_uuid",
)
print(eval_suite_report.eval_suite_report_uuid)
curl \
--request GET 'https://api.aymara.ai/v2/eval-reports/{report_uuid}' \
--header "x-api-key: $API_KEY"
Response examples (200)
{
"eval_suite_report_uuid": "string",
"status": "created",
"eval_run_reports": [
{
"eval_run_report_uuid": "string",
"eval_run_uuid": "string",
"eval_run": {
"eval_run_uuid": "string",
"eval_uuid": "string",
"name": "string",
"status": "created",
"created_at": "2025-05-04T09:42:00Z",
"updated_at": "2025-05-04T09:42:00Z",
"evaluation": {
"eval_uuid": "string",
"name": "string",
"ai_description": "string",
"ai_instructions": "string",
"eval_type": "string",
"eval_instructions": "string",
"language": "en",
"modality": "text",
"ground_truth": "string",
"num_prompts": 100,
"prompt_examples": [
{
"content": "string",
"example_uuid": "string",
"type": "good",
"explanation": "string"
}
],
"is_jailbreak": false,
"is_sandbox": false,
"workspace_uuid": "string",
"status": "created",
"created_at": "2025-05-04T09:42:00Z",
"updated_at": "2025-05-04T09:42:00Z"
},
"ai_description": "string",
"workspace_uuid": "string",
"pass_rate": 42.0,
"num_prompts": 42,
"num_responses_scored": 42,
"responses": [
{
"prompt_uuid": "string",
"thread_uuid": "string",
"turn_number": 1,
"continue_thread": false,
"content": "string",
"content_type": "text",
"exclude_from_scoring": false,
"ai_refused": false,
"response_uuid": "string",
"explanation": "string",
"confidence": 42.0,
"is_passed": true,
"next_prompt": {
"prompt_uuid": "string",
"thread_uuid": "string",
"turn_number": 1,
"content": "string",
"category": "string"
}
}
]
},
"passing_responses_summary": "string",
"failing_responses_summary": "string",
"improvement_advice": "string"
}
],
"overall_improvement_advice": "string",
"overall_failing_responses_summary": "string",
"overall_passing_responses_summary": "string",
"created_at": "2025-05-04T09:42:00Z",
"updated_at": "2025-05-04T09:42:00Z",
"remaining_reports": 42
}
Response examples (400)
{
"error": {
"code": "auth.invalid_key",
"message": "string",
"details": {}
},
"request_id": ""
}
Response examples (401)
{
"error": {
"code": "auth.invalid_key",
"message": "string",
"details": {}
},
"request_id": ""
}
Response examples (403)
{
"error": {
"code": "auth.invalid_key",
"message": "string",
"details": {}
},
"request_id": ""
}
Response examples (404)
{
"error": {
"code": "auth.invalid_key",
"message": "string",
"details": {}
},
"request_id": ""
}
Response examples (409)
{
"error": {
"code": "auth.invalid_key",
"message": "string",
"details": {}
},
"request_id": ""
}
Response examples (422)
{
"error": {
"code": "auth.invalid_key",
"message": "string",
"details": {}
},
"request_id": ""
}
Response examples (429)
{
"error": {
"code": "auth.invalid_key",
"message": "string",
"details": {}
},
"request_id": ""
}
Response examples (500)
{
"error": {
"code": "auth.invalid_key",
"message": "string",
"details": {}
},
"request_id": ""
}
Response examples (503)
{
"error": {
"code": "auth.invalid_key",
"message": "string",
"details": {}
},
"request_id": ""
}