---
title: "List artifacts"
method: GET
path: "/projects/{project_name_or_id}/artifacts"
tags: ["project"]
---

# List artifacts

`GET /projects/{project_name_or_id}/artifacts`

List artifacts of the specified project

## Path parameters

- `project_name_or_id` string, required

## Query parameters

- `q` string
- `sort` string
- `page` integer
- `page_size` integer
- `with_tag` boolean
- `with_label` boolean
- `with_scan_overview` boolean
- `with_sbom_overview` boolean
- `with_immutable_status` boolean
- `with_accessory` boolean
- `latest_in_repository` boolean

## Headers

- `X-Request-Id` string
- `X-Is-Resource-Name` boolean
- `X-Accept-Vulnerabilities` string

## Response `200`

Success

- Artifact[]
  - `id` integer — The ID of the artifact
  - `type` string — The type of the artifact, e.g. image, chart, etc
  - `media_type` string — The media type of the artifact
  - `manifest_media_type` string — The manifest media type of the artifact
  - `artifact_type` string — The artifact_type in the manifest of the artifact
  - `project_id` integer — The ID of the project that the artifact belongs to
  - `repository_id` integer — The ID of the repository that the artifact belongs to
  - `repository_name` string — The name of the repository that the artifact belongs to
  - `digest` string — The digest of the artifact
  - `size` integer — The size of the artifact
  - `icon` string — The digest of the icon
  - `push_time` string, date-time — The push time of the artifact
  - `pull_time` string, date-time — The latest pull time of the artifact
  - `extra_attrs` ExtraAttrs
  - `annotations` Annotations
  - `references` Reference[]
    - `parent_id` integer — The parent ID of the reference
    - `child_id` integer — The child ID of the reference
    - `child_digest` string — The digest of the child artifact
    - `platform` Platform
      - `architecture` string — The architecture that the artifact applys to
      - `os` string — The OS that the artifact applys to
      - `'os.version'` string — The version of the OS that the artifact applys to
      - `'os.features'` string[] — The features of the OS that the artifact applys to
      - `variant` string — The variant of the CPU
    - `annotations` Annotations
    - `urls` string[] — The download URLs
  - `tags` Tag[]
    - `id` integer — The ID of the tag
    - `repository_id` integer — The ID of the repository that the tag belongs to
    - `artifact_id` integer — The ID of the artifact that the tag attached to
    - `name` string — The name of the tag
    - `push_time` string, date-time — The push time of the tag
    - `pull_time` string, date-time — The latest pull time of the tag
    - `immutable` boolean — The immutable status of the tag
  - `addition_links` AdditionLinks
  - `labels` Label[]
    - `id` integer — The ID of the label
    - `name` string — The name the label
    - `description` string — The description the label
    - `color` string — The color the label
    - `scope` string — The scope the label
    - `project_id` integer — The ID of project that the label belongs to
    - `creation_time` string, date-time — The creation time the label
    - `update_time` string, date-time — The update time of the label
  - `scan_overview` ScanOverview — The scan overview attached in the metadata of tag
  - `sbom_overview` SBOMOverview — The generate SBOM overview information
    - `start_time` string, date-time — The start time of the generating sbom report task
    - `end_time` string, date-time — The end time of the generating sbom report task
    - `scan_status` string — The status of the generating SBOM task
    - `sbom_digest` string — The digest of the generated SBOM accessory
    - `report_id` string — id of the native scan report
    - `duration` integer — Time in seconds required to create the report
    - `scanner` Scanner
      - `name` string — Name of the scanner
      - `vendor` string — Name of the scanner provider
      - `version` string — Version of the scanner adapter
  - `accessories` Accessory[]
    - `id` integer — The ID of the accessory
    - `artifact_id` integer — The artifact id of the accessory
    - `subject_artifact_id` integer — Going to be deprecated, use repo and digest for insteand. The subject artifact id of the accessory.
    - `subject_artifact_digest` string — The subject artifact digest of the accessory
    - `subject_artifact_repo` string — The subject artifact repository name of the accessory
    - `size` integer — The artifact size of the accessory
    - `digest` string — The artifact digest of the accessory
    - `type` string — The artifact size of the accessory
    - `icon` string — The icon of the accessory
    - `creation_time` string, date-time — The creation time of the accessory

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `500` — Internal server error

---

[API](https://skmtc.dev/goharbor/apis/harbor-api.md) · [All operations](https://skmtc.dev/goharbor/apis/harbor-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/goharbor/harbor-api/revisions/62d78801f8df/schema)