---
updatedAt: 2026-07-26T12:14:49.000Z
agentTools:
  siteIndex: https://docs.jfrog.com/llms.txt
  projectIndex: https://docs.jfrog.com/security/llms.txt
---

# Get image artifact status in runtime

# OpenAPI definition

```json
{
  "openapi": "3.0.2",
  "info": {
    "title": "Runtime Security RESTful API",
    "version": "1.0.0",
    "description": "This document describes the Runtime Security RESTful API.<br/>\nAt the moment these API Endpoints can only be used internally,<br/>\nby the Runtime Frontend and other JPD services.\n"
  },
  "servers": [
    {
      "url": "http://localhost:9999/v1",
      "description": "localhost"
    },
    {
      "url": "http://demo-runtime.jfrog.net/v1",
      "description": "demo"
    }
  ],
  "tags": [
    {
      "name": "Runtime Status",
      "description": "Artifact, image, application version, and repository runtime status checks."
    }
  ],
  "paths": {
    "/scan_list/images/status": {
      "post": {
        "tags": [
          "Runtime Status"
        ],
        "summary": "Get image artifact status in runtime",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "repoPath"
                ],
                "properties": {
                  "repoPath": {
                    "type": "string"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/ImageStatusResponseEntity"
          },
          "404": {
            "$ref": "#/components/responses/ResourceNotFound"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "ImageVersionVulnerabilities": {
        "required": [
          "critical",
          "high",
          "imageTag",
          "isScannedByXray",
          "medium",
          "total",
          "unknown",
          "low"
        ],
        "type": "object",
        "properties": {
          "critical": {
            "type": "integer"
          },
          "high": {
            "type": "integer"
          },
          "imageTag": {
            "type": "string"
          },
          "isScannedByXray": {
            "type": "boolean"
          },
          "medium": {
            "type": "integer"
          },
          "total": {
            "type": "integer"
          },
          "unknown": {
            "type": "integer"
          },
          "low": {
            "type": "integer"
          }
        }
      },
      "ImageTagEntity": {
        "type": "object",
        "x-oapi-codegen-extra-tags": {
          "gorm": "serializer:json"
        },
        "required": [
          "imageName",
          "registry",
          "repositoryPath",
          "tag",
          "risks",
          "vulnerabilitySummary",
          "status",
          "workloadsCount",
          "clustersCount",
          "cloudProviders",
          "architecture",
          "sha256"
        ],
        "properties": {
          "sha256": {
            "type": "string"
          },
          "imageName": {
            "type": "string"
          },
          "registry": {
            "type": "string"
          },
          "repositoryPath": {
            "type": "string"
          },
          "tag": {
            "type": "string"
          },
          "risks": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RiskKey"
            }
          },
          "vulnerabilitySummary": {
            "$ref": "#/components/schemas/ImageVersionVulnerabilities"
          },
          "status": {
            "type": "string"
          },
          "workloadsCount": {
            "type": "integer"
          },
          "clustersCount": {
            "type": "integer"
          },
          "cloudProviders": {
            "type": "array",
            "x-oapi-codegen-extra-tags": {
              "gorm": "serializer:json"
            },
            "items": {
              "type": "string"
            }
          },
          "architecture": {
            "type": "string"
          }
        }
      },
      "RiskKey": {
        "type": "string",
        "enum": [
          "malicious",
          "critical_and_applicable_cves",
          "external_exposed",
          "privilege_workloads",
          "untrusted_registry_images",
          "integrity_violation"
        ]
      }
    },
    "responses": {
      "ResourceNotFound": {
        "description": "Not Found",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "error": {
                  "type": "string"
                }
              }
            },
            "examples": {
              "resource not found": {
                "value": {
                  "error": "Resource not found"
                }
              }
            }
          }
        }
      },
      "ImageStatusResponseEntity": {
        "description": "OK",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "x-oapi-codegen-extra-tags": {
                "gorm": "serializer:json"
              },
              "required": [
                "actionName",
                "link",
                "tooltip",
                "data"
              ],
              "properties": {
                "actionName": {
                  "type": "string"
                },
                "link": {
                  "type": "string"
                },
                "tooltip": {
                  "type": "string"
                },
                "data": {
                  "type": "object",
                  "properties": {
                    "imageTagSummary": {
                      "$ref": "#/components/schemas/ImageTagEntity"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
```