Get Evaluation

JFrog REST APIs

Content Type
REST API

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

evaluationId

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