---
title: "GET /v1/jobs/{jobId}/artifacts"
description: "Download a job's output files — Lists the output files of a finished job you can read, each with a presigned download URL that expires after 5 minutes."
full: true
---

**Auth:** required. Send an `ivy_` API key (`Authorization: Bearer ivy_…`), a signed-in session token (`Authorization: Bearer …`) or the session cookie (browser sessions). See [Authentication](/docs/api/authentication).

Lists the output files of a finished job you can read, each with a presigned download URL that expires after 5 minutes. Fetch `download_url` with a plain `GET` and no auth header; call this route again for fresh URLs once they expire.

Only files the job itself recorded are listed, and only those that exist in storage. A job you cannot read, a job outside your key's project scope and a job that does not exist all return the same 404. Guests cannot use this route.

## Request

### Path parameters

- `jobId` (string (uuid)) —
Job UUID.

### Query parameters

- `types` (string) —
Comma-separated file types to list, from `pdb`, `sdf`, `csv`, `txt`, `zip` and `json`. Defaults to all of them.

## Responses

### `200` OK

The job's output files with download URLs (an empty `artifacts` array when none are stored)

Response shape:

- `job_id` (string (uuid)) —

- `job_status` (string) —

- `job_type` (string) —

- `expires_in` (integer) —
Seconds until the earliest `download_url` expires (at most 300)

- `artifacts` (object[]) —

### `400` Bad Request

`types` names an unknown file type

Response shape: `object`

### `401` Unauthorized

Authentication required

Response shape: `object`

### `404` Not Found

Resource not found

Response shape: `object`

### `409` Conflict

The job has not completed yet; poll `GET /api/v1/jobs/{job_id}` first

Response shape: `object`

### `429` Too Many Requests

Rate limit exceeded

Response shape: `object`

### `500` Internal Server Error

Listing failed; the error is logged server-side

Response shape: `object`

### `503` Service Unavailable

File storage is not available

Response shape: `object`

**curl**

```bash
curl -X GET 'https://ivybiosciences.com/api/v1/jobs/{jobId}/artifacts' \
  -H "Authorization: Bearer $IVY_API_KEY"
```

**JavaScript**

```js
const res = await fetch('https://ivybiosciences.com/api/v1/jobs/{jobId}/artifacts', {
  method: 'GET',
  headers: {
    'Authorization': `Bearer ${process.env.IVY_API_KEY}`,
  },
});
const data = await res.json();
```

**Python**

```python
import os, requests

res = requests.get(
    "https://ivybiosciences.com/api/v1/jobs/{jobId}/artifacts",
    headers={"Authorization": f"Bearer {os.environ['IVY_API_KEY']}"},
)
data = res.json()
```
