---
title: "Downloads the contents of an Artifact snapshot"
method: GET
path: "/api/v1/artifacts/{id}/snapshots/{snapshotId}/contents"
tags: ["Artifact"]
---

# Downloads the contents of an Artifact snapshot

`GET /api/v1/artifacts/{id}/snapshots/{snapshotId}/contents`

## Request

- Base URL: `/` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/v1/artifacts/{id}/snapshots/{snapshotId}/contents`
- Auth: none declared
- TypeScript: <https://skmtc.dev/usnistgov/apis/dioptra-rest-api/docs/api/v1/artifacts/:id/snapshots/:snapshotId/contents/get.ts> (a function with typed inputs; its response is checked against the schema)

Args:
    id: the resource id of the artifact
    snapshotId: the snapshot resource id of the artifact

Returns:
    A list of the files associated with artifact.

## Query parameters

- `path` string
- `fileType` string

## Headers

- `X-Fields` string, mask

## Response `200`

Success

- ArtifactFileDump[]
  - `isDir` boolean: Whether the file denotes a directory or not.
  - `fileSize` integer: The size in bytes of the file.
  - `fileUrl` string: URL for accessing the contents of the Artifact.
  - `relativePath` string: Relative path to the Artifact URI.

## Changes

- **2026-09-30** `7615a76631a4`: 2 warning, 2 info
  - deleted the `path` request parameter `id`
  - deleted the `path` request parameter `snapshotId`
  - api tag `Artifact` added
  - api tag `Artifacts` removed
- **2026-02-11** `a73101579c5c`: 1 info
  - endpoint added
- **2024-07-26** `9a36b9043379`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/usnistgov/apis/dioptra-rest-api/changes/api/v1/artifacts/:id/snapshots/:snapshotId/contents/get.md)

---

[API](https://skmtc.dev/usnistgov/apis/dioptra-rest-api.md) - [All operations](https://skmtc.dev/usnistgov/apis/dioptra-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/usnistgov/apis/dioptra-rest-api/revisions/e1a0ec3a40b2?raw)