Description: Retrieves a single evaluation from the Evaluation History by its ID, including the recorded decision, inputs, effective policies, and detailed rule-level breakdown.
Security:
Usage: GET https://{{artifactory-host}}/unifiedpolicy/api/v1/evaluations/{evaluationId}
Produces:
Path Parameters:
Name | Type | Required | Description |
|---|---|---|---|
| string | Required | The unique identifier of the evaluation to retrieve |
Sample Response:
{
"id": "eval-12345",
"timestamp": "2024-01-20T14:30:00Z",
"decision": "fail",
"explanation": "Application version promotion evaluation blocked due to presence of critical vulnerability",
"action": {
"type": "certify_to_gate",
"stage": { "key": "qa", "gate": "entry" }
},
"resource": {
"identifier": {
"type": "application_version",
"key": "web-application",
"version": "2.1.0"
},
"hierarchy": {
"project": { "key": "prj-security" },
"application": {
"key": "web-application",
"labels": [
{ "key": "environment", "value": "production" }
]
},
"application_version": { "version": "2.1.0" }
}
},
"policies": [
{ "id": "1001", "name": "Security Vulnerability Policy", "enabled": true, "mode": "block" }
],
"decision_breakdown": [
{
"id": "rule-eval-1",
"timestamp": "2024-01-20T14:30:00Z",
"rule_id": "12345",
"resource": {
"type": "application_version",
"key": "web-application",
"version": "2.1.0"
},
"input": {
"findings": [
{ "id": "vuln-001", "severity": "critical", "type": "vulnerability" }
]
},
"output": {
"violated_findings": ["vuln-001"],
"decision": "fail",
"explanation": "Critical vulnerability found"
}
}
],
"context": {
"user": "admin",
"timestamp": "2024-01-20T14:30:00Z"
}
}Status Codes
Code | Description |
|---|---|
404 | Not Found |
401 | Unauthorized |
403 | Forbidden |
500 | Internal Server Error |