---
title: "Describe Docker Artifact Layers"
method: GET
path: "/registry/{registry_ref}/artifact/{artifact}/version/{version}/docker/layers"
tags: ["Docker Artifacts"]
---

# Describe Docker Artifact Layers

`GET /registry/{registry_ref}/artifact/{artifact}/version/{version}/docker/layers`

## Request

- Base URL: `/api/v1` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/v1/registry/{registry_ref}/artifact/{artifact}/version/{version}/docker/layers`
- Auth: none declared

Get Docker Artifact Layers

## Path parameters

- `registry_ref` string, required
- `artifact` string, required
- `version` string, required

## Query parameters

- `digest` string, required

## Response `200`

response to get artifact layers

- object
  - `status` 'SUCCESS' | 'FAILURE' | 'ERROR', required: Indicates if the request was successful or not
  - `data` DockerLayersSummary, required: Harness Layers Summary
    - `digest` string, required
    - `osArch` string
    - `layers` DockerLayerEntry[]
      - `command` string, required
      - `size` string

## Other responses

- `400`: Bad request
- `401`: Unauthenticated
- `403`: Unauthorized
- `404`: The specified resource was not found
- `500`: Internal server error

---

[API](https://skmtc.dev/harness/apis/harness-artifact-registry-api.md) · [All operations](https://skmtc.dev/harness/apis/harness-artifact-registry-api/llms.txt) · [OpenAPI document](https://skmtc.dev/harness/apis/harness-artifact-registry-api/revisions/e315ed26a2f1?raw)