Skip to main content

Get Registry Scan Status



x-prisma-cloud-target-env: {"permission":"monitorImages","saas":true,"self-hosted":true}
x-public: true

Returns the status of a regular registry scan that might include the following information:

  • Scan is completed: "completed": true
  • Scan is ongoing.
  • Errors: 10 most recent aggregated errors that occured during the scan with error messages such as:
    • "Failed to retrieve repositories info..."
    • "Failed to query image details..."
    • "No available Defender was found"

To view the more details about the progress of a regular or on-demand registry scan, use the /registry/progress API endpoint.

cURL Request

Refer to the following example cURL command:

$ curl -k \
-u <USER> \
-H 'Content-Type: application/json' \
-X GET \


"scanTime": "2019-07-31T19:42:49.036311567Z",
"completed": true



ScanStatus represents the status of current scan

    completed boolean

    Indicates if scanning has successfully completed (true) or not (false).

    errors string[]

    List of errors that occurred during the last scan.

    hostname string

    Name of the host where Defender runs.

    scanTime date-time

    Datetime of the last completed scan.

    scanning boolean

    Indicates whether scanning is in progress (true) or not (false).

    selective boolean

    Indicates if the scan is for a specific resource (true) or not (false).