---
title: "List files/folders in a job folder"
method: GET
path: "/projects/{owner}/{name}/jobs/{job_id}/artifacts"
tags: ["Jobs"]
---

# List files/folders in a job folder

`GET /projects/{owner}/{name}/jobs/{job_id}/artifacts`

## Request

- Base URL: `https://api.pollination.solutions` (the document declares no server; this is the origin it was published from)
- URL: `https://api.pollination.solutions/projects/{owner}/{name}/jobs/{job_id}/artifacts`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-pollination-token`
- TypeScript: <https://skmtc.dev/pollination/apis/pollination-server/docs/projects/:owner/:name/jobs/:job_id/artifacts/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve a list of artifacts in a job folder

## Path parameters

- `owner` string, required
- `name` string, required
- `job_id` string, required

## Query parameters

- `path` string[]: The path to an file within a project folder
- `page` integer: Page number starting from 1
- `per-page` integer: Number of items per page

## Response `200`

Retrieved

- FileMetaList: A list response from a pagination request
  - `page` integer, required: The current page the pagination request is on
  - `per_page` integer, required: The number of pages per pagination request
  - `next_page` integer: The next page, if this on is not the last
  - `page_count` integer, required: The total number of pages
  - `total_count` integer, required: The total number of resources matching the list request
  - `resources` FileMeta[], required
    - `key` string, required
    - `file_type` string, required
    - `file_name` string, required
    - `last_modified` string, date-time
    - `size` integer

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/pollination/apis/pollination-server.md) - [All operations](https://skmtc.dev/pollination/apis/pollination-server/llms.txt) - [OpenAPI document](https://skmtc.dev/pollination/apis/pollination-server/revisions/c1f3c6d96b31?raw)