---
title: "List artifacts"
method: GET
path: "/api/v1/artifacts"
tags: ["artifacts"]
---

# List artifacts

`GET /api/v1/artifacts`

## Request

- Base URL: `https://makespdf.com`
- URL: `https://makespdf.com/api/v1/artifacts`
- Auth: HTTP bearer

The caller's retained renders (7 days by default), newest first. Download one with GET /api/v1/artifacts/{id}/pdf.

## Query parameters

- `kind` 'markdown' | 'canvas' | 'dsl-preview' | 'dsl-render' | 'alt-text-report' | 'tag-report'
- `templateId` string
- `limit` integer
- `offset` integer

## Response `200`

The caller's artifacts.

- ArtifactList
  - `items` Artifact[], required
    - `artifactId` string, required
    - `kind` 'markdown' | 'canvas' | 'dsl-preview' | 'dsl-render' | 'alt-text-report' | 'tag-report', required
    - `origin` 'ui' | 'api' | 'cli'
    - `templateId` string, nullable
    - `templateName` string, nullable
    - `status` 'success' | 'error', required
    - `pageCount` integer, nullable
    - `byteSize` integer, nullable
    - `creditsCharged` integer, nullable
    - `errorMessage` string, nullable
    - `createdAt` string, date-time, required
    - `expiresAt` string, date-time, required
    - `hasPdf` boolean, required
  - `total` integer, required
  - `limit` integer, required
  - `offset` integer, required

## Other responses

- `400`: Malformed body or failed validation. Never billed.
- `401`: Missing or invalid Bearer token. The body links the docs, llms.txt and the auth skill.
- `429`: Rate limit exceeded.
- `500`: Unexpected server error. Never billed.

---

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