---
title: "List agentic videos"
method: GET
path: "/agentic-videos"
tags: ["Agentic Videos"]
---

# List agentic videos

`GET /agentic-videos`

List your agentic videos, most recent first. Results are paginated: when more
pages are available the response includes a `token` — pass it back as the `token`
query param to fetch the next page.

## Query parameters

- `limit` number, double
- `token` string
- `sort_by` 'created_at' | 'modified_at'
- `order` 'ascending' | 'descending'

## Response `200`

Agentic videos retrieved

- ListAgenticVideosResponseDto — Response returned by `GET /agentic-videos` (a single page of results).
  - `agentic_videos` AgenticVideo[], required — The caller's agentic videos for this page, ordered newest first.
    - `video_id` string, required — Unique identifier of the agentic video.
    - `name` string, required — Display name of the agentic video.
    - `video_url` string — CDN URL of the processed video, available once processing reaches `ready`.
    - `thumbnail_url` string — CDN URL of the video thumbnail, available once one has been generated.
    - `duration` number, double — Duration of the source video, in seconds.
    - `language` string — Detected spoken language of the video, as an IETF BCP-47 language tag.
    - `status` 'created' | 'started' | 'ready' | 'done' | 'error', required — Processing status of an agentic video. - `created` — the video was accepted and is queued for processing. - `started` — the video is being processed. - `ready` — the agent has been created and is initializing. - `done` — the agent is active and the agentic video is fully available to viewers. - `error` — processing failed; see the `error` field for details.
    - `error` AgenticVideoError
      - `code` 'youtube_not_supported' | 'ingest_failed' | 'moderation_failed' | 'transcription_failed' | 'agent_creation_failed', required
      - `message` string
    - `agent_id` string — ID of the agent generated from this video, present once the agent has been created.
    - `show_agent_on_video_end` boolean, required — Whether the agent automatically appears when the video finishes playing.
    - `greetings` AgenticVideoGreetings — Greetings spoken by the agent at specific moments in the agentic-video flow.
      - `on_click` string — Greeting when the viewer first clicks ASK.
      - `on_video_end` string — Greeting when the video ends and the agent auto-appears.
    - `background` PresenterBackground
      - `color` string — Background color of the Avatar.
      - `source_url` string — Image URL used as the Avatar background.
    - `bubble_text` string — Text shown in the call-to-action bubble that invites viewers to start chatting.
    - `created_by` string, required — ID of the user who created the agentic video.
    - `created_at` string, required — Creation timestamp (ISO-8601).
    - `modified_at` string, required — Timestamp of the last update (ISO-8601).
  - `token` string — Pagination token for the next page. Present only when more results are available; pass it back as the `token` query parameter to fetch the next page.

## Other responses

- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.net/d-id/apis/realtime-endpoints.md) · [All operations](https://skmtc.net/d-id/apis/realtime-endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/d-id/realtime-endpoints/versions/2f2425e1b6b6/schema)