---
title: "List Short Segments"
method: GET
path: "/jobs/{job_id}/segments"
tags: ["Shorts"]
---

# List Short Segments

`GET /jobs/{job_id}/segments`

Returns all segments generated for a specific short. While the short is still processing, `segments` will be `null`. Once the status is `ready`, the full list of segments with preview URLs, thumbnails, transcriptions, and AI scores is returned.

## Path parameters

- `job_id` string, required

## Response `200`

200

- object
  - `job` object
    - `id` string — UUID of the short.
    - `status` 'processing' | 'rendering_previews' | 'ready' | 'failed' — Current short status.
    - `total_segments` number — Total number of segments. `null` while processing.
    - `analysis_duration` number — Duration of the analyzed video segment in seconds.
    - `created_at` string — ISO 8601 creation timestamp.
  - `segments` object[] — `null` while the short is processing. Array of segments when ready.
    - `id` string — UUID of the segment.
    - `job_id` string — UUID of the parent short.
    - `segment_index` number — Zero-based index of the segment.
    - `title` string — AI-generated title for the segment.
    - `status` 'processing' | 'preview_ready' | 'failed' — Current segment status.
    - `duration_seconds` number — Duration of the segment in seconds.
    - `score` number — AI relevance score from 0.0 to 1.0.
    - `aspect_ratio` string — Aspect ratio of the segment (e.g. `9:16`).
    - `retry_count` number — Number of processing retries.
    - `created_at` string — ISO 8601 creation timestamp.
    - `updated_at` string — ISO 8601 last update timestamp.
    - `completed_at` string — ISO 8601 completion timestamp.
    - `preview_url` string — CloudFront signed URL for the preview video.
    - `thumbnail` string — S3 signed URL for the segment thumbnail.
    - `transcription` string — Full transcription text of the segment.
    - `description` string — AI-generated description of the segment content.
    - `feedback` 'like' | 'dislike' — User feedback for this segment. `null` if no feedback.

## Other responses

- `400` — 400
- `500` — 500

---

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