---
title: "Download a cache artifact"
method: GET
path: "/v8/artifacts/{hash}"
tags: ["artifacts"]
---

# Download a cache artifact

`GET /v8/artifacts/{hash}`

## Request

- Base URL: `https://api.vercel.com`
- URL: `https://api.vercel.com/v8/artifacts/{hash}`
- Auth: HTTP bearer

Downloads a cache artifact indentified by its `hash` specified on the request path. The artifact is downloaded as an octet-stream. The client should verify the content-length header and response body.

## Path parameters

- `hash` string, required: The artifact hash

## Query parameters

- `teamId` string
- `slug` string

## Headers

- `x-artifact-client-ci` string: The continuous integration or delivery environment where this artifact is downloaded.
- `x-artifact-client-interactive` integer: 1 if the client is an interactive shell. Otherwise 0

## Response `200`

- string, binary: An octet stream response that will be piped to the response stream.

## Other responses

- `400`: One of the provided values in the request query is invalid. One of the provided values in the headers is invalid
- `401`: The request is not authorized.
- `402`: The account is missing a payment so payment method must be updated
- `403`: The customer has reached their spend cap limit and has been paused. An owner can disable the cap or raise the limit in settings. The Remote Caching usage limit has been reached for this account for this billing cycle. Remote Caching has been disabled for this team or user. An owner can enable it in the billing settings. You do not have permission to access this resource.
- `404`: The artifact was not found
- `410`

## Changes

- **2026-09-01** `606993b34ea5`: 2 warning, 2 info
  - deleted the `header` request parameter `'x-Artifact-Client-Ci'`
  - deleted the `header` request parameter `'x-Artifact-Client-Interactive'`
  - added the new optional `header` request parameter `x-artifact-client-ci`
  - added the new optional `header` request parameter `x-artifact-client-interactive`
- **2026-07-21** `2ae10ee9d21c`: 1 info
  - added the non-success response with the status `410`
- **2026-06-11** `14b4658f819e`: 2 warning, 2 info
  - deleted the `header` request parameter `x-artifact-client-ci`
  - deleted the `header` request parameter `x-artifact-client-interactive`
  - added the new optional `header` request parameter `'x-Artifact-Client-Ci'`
  - added the new optional `header` request parameter `'x-Artifact-Client-Interactive'`
- **2025-03-19** `37b482c58c92`: 1 info
  - added the new optional `query` request parameter `slug`
- **2022-12-06** `8eb562567170`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/vercel/apis/vercel-api/changes/v8/artifacts/:hash/get.md)

---

[API](https://skmtc.dev/vercel/apis/vercel-api.md) - [All operations](https://skmtc.dev/vercel/apis/vercel-api/llms.txt) - [OpenAPI document](https://skmtc.dev/vercel/apis/vercel-api/revisions/60686c0e1f6a?raw)