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

# Describe Artifact files

`GET /registry/{registry_ref}/artifact/{artifact}/version/{version}/files`

## 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}/files`
- Auth: none declared

Get Artifact files

## Path parameters

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

## Query parameters

- `artifact_type` 'model' | 'dataset'
- `page` integer
- `size` integer
- `sort_order` string
- `sort_field` string
- `search_term` string

## Response `200`

response to get artifact files

- object
  - `status` 'SUCCESS' | 'FAILURE' | 'ERROR', required: Indicates if the request was successful or not
  - `data` ListFileDetail, required: A list of Harness Artifact Files
    - `pageCount` integer: The total number of pages
    - `itemCount` integer: The total number of items
    - `pageSize` integer: The number of items per page
    - `pageIndex` integer: The current page
    - `files` FileDetail[], required: A list of Harness Artifact Files
      - `name` string, required
      - `size` string, required
      - `checksums` string[], required
      - `downloadCommand` string, required
      - `createdAt` string, required
      - `path` string, required

## Other responses

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

## Changes

- **2025-11-12** `9eb5f9d9603e`: 1 info
  - added the required property `data/files/items/path` to the response with the `200` status
- **2025-10-07** `508da4565603`: 1 breaking, 4 warning, 1 info
  - removed the required property `files` from the response with the `200` status
  - removed the optional property `itemCount` from the response with the `200` status
  - removed the optional property `pageCount` from the response with the `200` status
  - removed the optional property `pageIndex` from the response with the `200` status
  - …2 more
- **2025-08-07** `821be84493dd`: 2 breaking, 2 info
  - removed the enum value `DATASET` from the `query` request parameter `artifact_type`
  - removed the enum value `MODEL` from the `query` request parameter `artifact_type`
  - added the new enum value `dataset` to the `query` request parameter `artifact_type`
  - added the new enum value `model` to the `query` request parameter `artifact_type`
- **2025-08-04** `c95e57236992`: 1 info
  - added the new optional `query` request parameter `artifact_type`
- **2025-01-24** `56f178653cfd`: 5 info
  - added the new optional `query` request parameter `page`
  - added the new optional `query` request parameter `search_term`
  - added the new optional `query` request parameter `size`
  - added the new optional `query` request parameter `sort_field`
  - …1 more

[Operation history](https://skmtc.dev/harness/apis/harness-artifact-registry-api/changes/registry/:registry_ref/artifact/:artifact/version/:version/files/get.md)

---

[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)