---
title: "Get Campaign Artifacts"
method: GET
path: "/v1/campaigns/{campaign_id}/artifacts"
tags: ["campaigns", "developer-api", "product-api", "product-api"]
---

# Get Campaign Artifacts

`GET /v1/campaigns/{campaign_id}/artifacts`

## Request

- Base URL: `https://api.myarchivist.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.myarchivist.ai/v1/campaigns/{campaign_id}/artifacts`
- Auth: HTTP bearer

Read-only campaign artifacts catalog (Hero Awards, Spotlights, Quotes, Key Moments, Session Handouts, Cast Analysis, Trading Cards).

Product-view only. Entries carry either a pre-rendered `imageUrl` or
`renderParams` for the public web card renderers.

## Path parameters

- `campaign_id` string, required

## Query parameters

- `type` string, nullable: Comma-separated artifact types to include: hero-award, spotlight, quote, key-moment, handout, cast-analysis, card (digital trading cards).
- `session_id` string, nullable: Restrict results to a single game session.
- `character_id` string, nullable: Restrict results to artifacts attributed to a single character. Matched by character name/aliases, since artifact rows carry a free-text character name rather than a foreign key.
- `page` integer
- `size` integer

## Headers

- `x-api-key` string, nullable

## Response `200`

Successful Response

- ArtifactCatalogResponse
  - `data` ArtifactRead[], required
    - `id` string, required
    - `artifact_type` string, required
    - `title` string, required
    - `subtitle` string, nullable
    - `description` string, nullable
    - `character_name` string, nullable
    - `entity_type` string, nullable
    - `entity_id` string, nullable
    - `session_id` string, nullable
    - `session_title` string, nullable
    - `session_number` integer, nullable
    - `session_date` string, date-time, nullable
    - `campaign_title` string, nullable
    - `image_url` string, nullable
    - `render_kind` string, nullable
    - `render_params` object, nullable
    - `order_index` integer, nullable
    - `pdf_page_count` integer, nullable
    - `pdf_saved_at` string, date-time, nullable
    - `created_at` string, date-time, nullable
  - `total` integer, required
  - `page` integer, required
  - `size` integer, required
  - `pages` integer, required
  - `type_counts` object, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/myarchivist/apis/archivist-public-api.md) · [All operations](https://skmtc.dev/myarchivist/apis/archivist-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/myarchivist/apis/archivist-public-api/revisions/3ea6ca7efc56?raw)
