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

# List Short Segments

`GET /jobs/{job_id}/segments`

## Request

- Base URL: `https://api-v2.pandavideo.com.br/shorts`
- URL: `https://api-v2.pandavideo.com.br/shorts/jobs/{job_id}/segments`
- Auth: API key in header `Authorization`

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.dev/pandavideo/apis/shorts.md) - [All operations](https://skmtc.dev/pandavideo/apis/shorts/llms.txt) - [OpenAPI document](https://skmtc.dev/pandavideo/apis/shorts/revisions/912538d74790?raw)