---
title: "List issue artifacts"
method: GET
path: "/repos/{owner}/{repo}/issues/{issue_number}/artifacts"
tags: ["issues"]
---

# List issue artifacts

`GET /repos/{owner}/{repo}/issues/{issue_number}/artifacts`

## Request

- Base URL: `https://api.github.com`
- URL: `https://api.github.com/repos/{owner}/{repo}/issues/{issue_number}/artifacts`
- Auth: none declared

Lists artifacts attached to an issue. Results are ordered by artifact number.

The `type` parameter filters the response to artifacts of one type.
Results can be requested by page. The page defaults to `1`; the page size
defaults to `30` and can be set from `1` to `100`.

The response is a bare array and does not include pagination metadata such as
a `Link` header, a total count, or the service's `has_next_page` signal.

## Path parameters

- `owner` string, required
- `repo` string, required
- `issue_number` integer, required

## Query parameters

- `type` 'generic' | 'link' | 'plan' | 'embedded_html'
- `per_page` integer
- `page` integer

## Response `200`

A list of artifacts attached to the issue.

- IssueArtifact[]
  - `id` integer, required: The globally unique identifier of the artifact.
  - `html_url` string, uri: The canonical browser URL for the artifact in its issue context.
  - `number` integer, required: The artifact number within the issue.
  - `type` string, required: The artifact type. The types supported for external creation and filtering are: - `generic` is a general-purpose Markdown document. - `link` represents a named link. - `plan` is a Markdown plan. - `embedded_html` is a self-contained HTML document. Its `body` contains the HTML source.
  - `name` string, required: The human-readable name of the artifact.
  - `body` string, required: The artifact content. For `embedded_html` artifacts, this is the HTML source.
  - `body_html` string, nullable, required: The artifact content rendered as HTML, or `null` if rendering times out or is skipped to protect the response's time budget. The raw content remains available in `body`.
  - `description` string, required: A short, generated summary of the artifact.
  - `creator` object, nullable, required: The user or integration that created the artifact.
    - `login` string, required
    - `id` integer, required
  - `updated_by_actor` object, nullable, required: The user or integration that most recently updated the artifact.
    - `login` string, required
    - `id` integer, required
  - `created_at` string, date-time, nullable, required: The time the artifact was created.
  - `updated_at` string, date-time, nullable, required: The time the artifact was last updated.

## Other responses

- `404`: Resource not found
- `410`: Gone
- `503`: Service unavailable

## Changes

- **2026-10-28** (2026-03-10) `981aa3c25d9e`: 1 info
  - the response property `items/description` became required for the status `200`
- **2026-10-27** (2026-03-10) `18226de6c75a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/github/apis/rest/changes/repos/:owner/:repo/issues/:issue_number/artifacts/get.md)

---

[API](https://skmtc.dev/github/apis/rest.md) - [All operations](https://skmtc.dev/github/apis/rest/llms.txt) - [OpenAPI document](https://skmtc.dev/github/apis/rest/revisions/981aa3c25d9e?raw)