Get all clips of a live stream | FastPix Developer Documentation

{
  "success": true,
  "data": [
    {
      "thumbnail": "https://images.fastpix.com/837f028b-dcaf-4c23-b368-3748641f74ac/thumbnail.png",
      "id": "cfeec1a3-6cbd-40df-a425-2ed7f8f72ced",
      "workspaceId": "6dc2b4e0-0615-42fd-a580-1f4aad932dfe",
      "streamId": "98f28be5ac9bd7a4205634691a1a096b",
      "maxResolution": "1080p",
      "sourceResolution": "1080p",
      "status": "Ready",
      "sourceAccess": false,
      "playbackIds": [
        {
          "id": "837f028b-dcaf-4c23-b368-3748641f74ac",
          "accessPolicy": "public",
          "accessRestrictions": {
            "domains": {
              "defaultPolicy": "allow",
              "allow": [],
              "deny": []
            },
            "userAgents": {
              "defaultPolicy": "allow",
              "allow": [],
              "deny": []
            }
          }
        }
      ],
      "tracks": [
        {
          "id": "f301a2a1-b40d-40fa-b419-4d0cd92a62f8",
          "type": "video",
          "width": 1920,
          "height": 1080,
          "frameRate": "30/1",
          "status": "available"
        }
      ],
      "isAudioOnly": false,
      "subtitleAvailable": true,
      "duration": "00:00:10",
      "aspectRatio": "16:9",
      "createdAt": "2025-01-09T06:44:44.617138Z",
      "updatedAt": "2025-01-09T06:44:53.742648Z"
    }
  ],
  "pagination": {
    "totalRecords": 100,
    "currentOffset": 1,
    "offsetCount": 10
  }
}

How it works

Provide the livestreamId as a parameter when calling this endpoint.
The API returns a paginated list of media clips created from the specified livestream.
Pagination helps maintain performance and usability when handling large sets of media files, making it easier to organize and manage content in bulk.

Use case

Suppose you’re hosting a live gaming event and want to showcase key moments from the stream — such as top plays or final match highlights. You can use this endpoint to fetch all clips generated from that livestream, display them in your dashboard, or use them for post-event editing and sharing.

Related guide: Instant live clipping

Retrieves a list of all media clips generated from a specific livestream. Each media entry includes metadata such as the clip media IDs, and other relevant details. A media clip is a segmented portion of an original media file (source live stream). Clips are often created for various purposes such as previews, highlights, or customized edits. #### How it works 1. Provide the livestreamId as a parameter when calling this endpoint. 2. The API returns a paginated list of media clips created from the specified livestream. 3. Pagination helps maintain performance and usability when handling large sets of media files, making it easier to organize and manage content in bulk. #### Use case Suppose you’re hosting a live gaming event and want to showcase key moments from the stream — such as top plays or final match highlights. You can use this endpoint to fetch all clips generated from that livestream, display them in your dashboard, or use them for post-event editing and sharing. Related guide: <a href="https://docs.fastpix.io/docs/instant-live-clipping">Instant live clipping</a>

Authentication

AuthorizationBasic

FastPix APIs are secured with Basic Authentication. Use your Access Token ID as the username and Secret Key as the password in the Authorization header of each API request.

Username: Access Token ID
Password: Secret Key

Activate your FastPix account to generate your API credentials. See the guide here

FastPix APIs are secured with Basic Authentication. Use your Access Token ID as the username and Secret Key as the password in the Authorization header of each API request. - <b>Username:</b> Access Token ID - <b>Password:</b> Secret Key Activate your FastPix account to generate your API credentials. <a href="https://docs.fastpix.io/docs/activate-account" target="_blank">See the guide here</a>

Path parameters

livestreamIdstringRequiredformat: "uuid"

The stream Id is unique identifier assigned to the live stream.

Query parameters

limitintegerOptional1-50Defaults to 10

Limit specifies the maximum number of items to display per page.

offsetintegerOptionalDefaults to 1

Offset determines the starting point for data retrieval within a paginated list.

orderByenumOptionalDefaults to desc

The values in the list can be arranged in two ways: DESC (Descending) or ASC (Ascending).

Allowed values:

Response

List of video media

successboolean

Demonstrates whether the request is successful or not.

datalist of objects

Displays the result of the request.

paginationobject

Pagination organizes content into pages for better readability and navigation.

How it works

Provide the livestreamId as a parameter when calling this endpoint.
The API returns a paginated list of media clips created from the specified livestream.
Pagination helps maintain performance and usability when handling large sets of media files, making it easier to organize and manage content in bulk.

Use case

Related guide: Instant live clipping

$	curl https://api.fastpix.com/v1/on-demand/b6f71268143f70c798a7851a0a92dcbf/live-clips \
>	-u "<username>:<password>"