---
title: "Get History V2"
method: GET
path: "/v2/threads/history/"
tags: ["threads"]
---

# Get History V2

`GET /v2/threads/history/`

History v2.

Returns a mixed feed of generated artifacts. Behaviour highlights:
- Default (GENERATED) includes both images and videos, filtered to user's threads.
- FAVOURITE mode returns only the selected media_type; if omitted, it defaults to images. Ordering uses the
  media-specific favourite id.
- LICENSED / PREVIEW modes remain image-only.

## Query parameters

- `mode` 'generated' | 'favourite' | 'licensed' | 'preview'
- `model_uids` string[]
- `thread_uids` string[]
- `search` string, nullable
- `media_type` 'image' | 'video'
- `before` string, nullable
- `last` integer, nullable
- `after` string, nullable
- `first` integer, nullable
- `include_cursor` boolean
- `cursor_uid` string, uuid

## Response `200`

OK

- CursorPaginatedResponseMessageAttachmentSchema
  - `items` MessageAttachmentSchema[], required — The list of results
    - `type` 'generation' | 'sketch' | 'reference' | 'preset', required
    - `image` ThreadImageOut — unresolved $ref
    - `preset` PresetOutSchema
      - `uid` string, uuid, nullable
      - `name` string, nullable
      - `type` string
      - `meta` object, nullable
    - `video` ThreadVideoOut
      - `uid` string, uuid, required
      - `title` string, nullable
      - `generated` boolean, nullable
      - `transparent` boolean
      - `created` string, date-time, required
      - `url` string, uri, required — Video URL
      - `preview_url` string, uri, nullable — Baked-background MP4 preview (transparent videos)
      - `thumbnail_url` string, uri, nullable — First-frame straight-alpha PNG (transparent videos)
      - `model` NestedModel
        - `id` integer, required
        - `uid` string, uuid, required
        - `public` boolean, required
        - `active` boolean, required
        - `inactivated` boolean, required
        - `name` string, nullable
        - `author` string, nullable
        - `weights_path` string, nullable
        - `priority` integer, nullable
        - `description` NestedModelDescription
          - `text` string, nullable
          - `general_prompt` string, nullable
          - `cover_image` NestedModelDescriptionCover
            - `generated` boolean, nullable
            - `created` string, date-time, nullable
            - `url` string, uri, nullable
            - `highres_url` string, uri, nullable
        - `created_by` NestedModelCreatedBy
          - `username` string, required
          - `printable_name` string, nullable
          - `uid` string, uuid, required
        - `owner_uid` string, uuid, nullable
        - `base_type` string, nullable
        - `default_prompt` string, nullable
        - `deleted_at` string, date-time, nullable
        - `is_trial` boolean, nullable
        - `trial_ends_at` string, date-time, nullable
        - `access` 'free' | 'licensed'
      - `generation_uid` string, uuid, nullable
      - `width` integer, nullable
      - `height` integer, nullable
      - `favourite` boolean, nullable
      - `is_licensed` boolean, nullable
      - `is_licensable` boolean, nullable
      - `license_state` string, nullable
      - `user_licenses` NestedVideoPurchaseSchema[], nullable
        - `created` string, date-time, required
        - `license_type` string, required
      - `thread_uid` string, uuid, nullable
      - `generation_params` CreateGenVideoParams
        - `type` 'create_video', required
        - `model_uid` string, uuid, nullable
        - `prompt` string
        - `size` unknown[], required
          - unknown
        - `start_time` number
        - `n_videos` integer, required
        - `duration` integer, required
        - `fps` integer, required
        - `transparent` boolean
        - `prompt_uid` string, uuid, nullable
        - `prompt_settings` PromptEnrichmentFeatureSetting[], nullable
          - `id` integer, required
          - `value` unknown, required
        - `preset_uids` string[], nullable
  - `count` integer, required
  - `total_count` integer, nullable
  - `has_next_page` boolean, nullable
  - `has_previous_page` boolean, nullable
  - `start_cursor` PaginationCursor
    - `values` unknown[], required
      - unknown
  - `end_cursor` PaginationCursor
    - `values` unknown[], required
      - unknown

## Other responses

- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.net/exactly/apis/exactly-api.md) · [All operations](https://skmtc.net/exactly/apis/exactly-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/exactly/exactly-api/revisions/0a81f72192af/schema)