---
title: "Scripts list view used by /scripts and the campaign wizard."
method: GET
path: "/api/v1/scripts"
tags: ["Scripts"]
---

# Scripts list view used by /scripts and the campaign wizard.

`GET /api/v1/scripts`

## Request

- Base URL: `https://api.avatarfactory.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.avatarfactory.io/api/v1/scripts`
- Auth: one of:
  - API key in cookie `session`
  - HTTP bearer

<br/>Scoped to the caller's own scripts, admins included (default-own<br/>scoping, spec §3.5, 2026-08-11). Filtering happens in SQL via<br/>`scope_query` inside the repository, with no post-fetch list<br/>comprehension.

## Query parameters

- `status` string
- `avatar_id` integer, nullable
- `source` string
- `account` string
- `category_id` integer, nullable
- `q` string, nullable

## Response `200`

OK

- ScriptListView
  - `avatars` AvatarOption[], required
    - `description` string, required
    - `id` integer, required
    - `name` string, required
    - `story` string, required
  - `cat_counts` object, required
  - `categories` CategoryRow[], required
    - `color` string, nullable
    - `id` integer, required
    - `name` string, required
  - `scraped_accounts` string[], required
  - `scripts` ScriptCard[], required
    - `avatar_face` string, nullable
    - `avatar_id` integer, nullable
    - `avatar_name` string, nullable
    - `category_color` string, nullable
    - `category_id` integer, nullable
    - `category_name` string, nullable
    - `id` integer, required
    - `ig_comments` integer, nullable
    - `ig_display_name` string, nullable
    - `ig_followers` integer, nullable
    - `ig_likes` integer, nullable
    - `ig_url` string, nullable
    - `ig_username` string, nullable
    - `ig_views` integer, nullable
    - `notes` string, nullable
    - `script_text` string, required
    - `source` string, nullable
    - `status` string, nullable
    - `title` string, nullable
    - `updated_at` string, date-time, nullable
    - `viral_score` integer, nullable

## Other responses

- `422`: Unprocessable Entity

---

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