---
title: "GET /api/ai_scripts/"
method: GET
path: "/api/ai_scripts/"
tags: ["ai_scripts"]
---

# GET /api/ai_scripts/

`GET /api/ai_scripts/`

Retrieve a list of videos, with an optional ids param to filter vdieo by their UUIDs.

## Query parameters

- `ids` string
- `ordering` string

## Response `200`

- AiScriptJob[]
  - `id` string, uuid, required
  - `url` string, uri
  - `title` string
  - `description` string
  - `language` 'af' | 'ar' | 'as' | 'az' | 'be' | 'bg' | 'bn' | 'bs' | 'ca' | 'cb' | 'cs' | 'cy' | 'da' | 'de' | 'el' | 'en' | 'es' | 'et' | 'fa' | 'fi' | 'fl' | 'fr' | 'ga' | 'gl' | 'gu' | 'ha' | 'he' | 'hi' | 'hr' | 'hu' | 'hy' | 'id' | 'is' | 'it' | 'ja' | 'jv' | 'ka' | 'kk' | 'kn' | 'ko' | 'ky' | 'lb' | 'ln' | 'lt' | 'lv' | 'mk' | 'ml' | 'mr' | 'ms' | 'ne' | 'nl' | 'no' | 'ny' | 'pa' | 'pl' | 'ps' | 'pt' | 'ro' | 'ru' | 'sd' | 'sk' | 'sl' | 'so' | 'sr' | 'sv' | 'sw' | 'ta' | 'te' | 'th' | 'tl' | 'tr' | 'uk' | 'ur' | 'vi' | 'zh' — * `af` - Afrikaans * `ar` - Arabic * `as` - Assamese * `az` - Azerbaijani * `be` - Belarusian * `bg` - Bulgarian * `bn` - Bengali * `bs` - Bosnian * `ca` - Catalan; Valencian * `cb` - Cebuano * `cs` - Czech * `cy` - Welsh * `da` - Danish * `de` - German * `el` - Greek, Modern * `en` - English * `es` - Spanish; Castilian * `et` - Estonian * `fa` - Persian * `fi` - Finnish * `fl` - Filipino * `fr` - French * `ga` - Irish * `gl` - Galician * `gu` - Gujarati * `ha` - Hausa * `he` - Hebrew (modern) * `hi` - Hindi * `hr` - Croatian * `hu` - Hungarian * `hy` - Armenian * `id` - Indonesian * `is` - Icelandic * `it` - Italian * `ja` - Japanese * `jv` - Javanese * `ka` - Georgian * `kk` - Kazakh * `kn` - Kannada * `ko` - Korean * `ky` - Kirghiz, Kyrgyz * `lb` - Luxembourgish, Letzeburgesch * `ln` - Lingala * `lt` - Lithuanian * `lv` - Latvian * `mk` - Macedonian * `ml` - Malayalam * `mr` - Marathi (Marāṭhī) * `ms` - Malay * `ne` - Nepali * `nl` - Dutch * `no` - Norwegian * `ny` - Chichewa; Chewa; Nyanja * `pa` - Panjabi, Punjabi * `pl` - Polish * `ps` - Pashto, Pushto * `pt` - Portuguese * `ro` - Romanian, Moldavian, Moldovan * `ru` - Russian * `sd` - Sindhi * `sk` - Slovak * `sl` - Slovene * `so` - Somali * `sr` - Serbian * `sv` - Swedish * `sw` - Swahili * `ta` - Tamil * `te` - Telugu * `th` - Thai * `tl` - Tagalog * `tr` - Turkish * `uk` - Ukrainian * `ur` - Urdu * `vi` - Vietnamese * `zh` - Chinese
  - `target_audience` string, nullable
  - `video_length` 15 | 30 | 45 | 60 — * `15` - 15 * `30` - 30 * `45` - 45 * `60` - 60
  - `script_styles` ScriptStylesEnum[] — List of script styles to generate, if not provided, four random script styles will be generated
  - `generated_scripts` AIScripts[], required
    - `paragraphs` string, required
    - `script_name` string, required
    - `script_style` string
    - `title` string, required
  - `failed_reason` string, nullable, required
  - `status` 'pending' | 'in_queue' | 'running' | 'failed' | 'done' | 'rejected', required — * `pending` - Pending * `in_queue` - In Queue * `running` - Running * `failed` - Failed * `done` - Done * `rejected` - Rejected
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `user` integer, nullable, required
  - `workspace` string, uuid, nullable, required
  - `product` Product, required
    - `id` string, uuid, required
    - `url` string, nullable
    - `slug` string, required
    - `title` string, nullable
    - `description` string, nullable
    - `image_urls` unknown
    - `video_urls` unknown
    - `image_selected` unknown
    - `video_selected` unknown
    - `reviews` unknown
    - `created_with` 'link_to_video' | 'link_to_video_art' | 'ai_script' | 'shopify_app' | 'image_ads' — * `link_to_video` - Link to Video * `link_to_video_art` - Link to Video Art * `ai_script` - AI Script * `shopify_app` - Shopify App * `image_ads` - Image Ads
    - `logo_url` string, uri, nullable
    - `price` string, nullable
    - `original_price` string, nullable
    - `promo_price` string, nullable
    - `use_promotional_info` boolean — Use promotional details for the product.
    - `highlight_features` string, nullable
    - `brand_info` string, nullable
    - `promotional_details` string, nullable
    - `trigger_insights` boolean — Trigger insights for the product.
    - `ai_summary` string, nullable
    - `ai_target_audiences` unknown
    - `ai_key_features` unknown
    - `ai_keywords` unknown
    - `ai_industry` integer, nullable
    - `ai_product_type` string, nullable
    - `updated_at` string, date-time, required
    - `primary_image_url` string, uri, nullable
    - `brand_colors` unknown
    - `qrcode_url` string, uri, nullable — URL to be encoded into a QR code for some visual styles. Default is null, no QR code will be generated.
    - `contact_number` string, nullable
  - `credits_used` number, required — Credits used in this api call

---

[API](https://skmtc.dev/creatify/apis/creatify-ai-api.md) · [All operations](https://skmtc.dev/creatify/apis/creatify-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/creatify/creatify-ai-api/revisions/7ca3bf8077ba/schema)