---
title: "Retrieve job artifacts"
method: GET
path: "/api/v4/projects/{id}/jobs/artifacts/{ref_name}/download"
tags: ["job_artifacts"]
---

# Retrieve job artifacts

`GET /api/v4/projects/{id}/jobs/artifacts/{ref_name}/download`

## Request

- Base URL: `https://gitlab.com`
- URL: `https://gitlab.com/api/v4/projects/{id}/jobs/artifacts/{ref_name}/download`
- Auth: none declared

Retrieves the artifacts archive for the latest successful job on a specified branch or tag.

## Path parameters

- `id` string, required
- `ref_name` string, required

## Query parameters

- `job` string, required
- `job_token` string
- `search_recent_successful_pipelines` boolean

## Response `200`

Retrieve job artifacts

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found

---

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