Get list of all media | FastPix Developer Documentation

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

{
  "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",
      "metadata": {
        "key1": "value1"
      },
      "mediaQuality": "standard",
      "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,
          "status": "available"
        }
      ],
      "generatedSubtitles": [],
      "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
  }
}

This endpoint returns a list of all media files uploaded to FastPix within a specific workspace. Each media entry contains data such as the media `id`, `createdAt`, `status`, `type` and more. It allows you to retrieve an overview of your media assets, making it easier to manage and review them. #### How it works Use the access token and secret key related to the workspace in the request header. When called, the API provides a paginated response containing all the media items in that specific workspace. This is helpful for retrieving a large volume of media and managing content in bulk. #### Example If you manage a video platform and need to review all uploaded media in your library to ensure that outdated or low-quality content isn’t being served, you can use this endpoint to retrieve a complete list of media. You can then filter, sort, or update items as needed.

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

{
  "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",
      "metadata": {
        "key1": "value1"
      },
      "mediaQuality": "standard",
      "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,
          "status": "available"
        }
      ],
      "generatedSubtitles": [],
      "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
  }
}

This endpoint returns a list of all media files uploaded to FastPix within a specific workspace. Each media entry contains data such as the media id, createdAt, status, type and more. It allows you to retrieve an overview of your media assets, making it easier to manage and review them.

How it works

Use the access token and secret key related to the workspace in the request header. When called, the API provides a paginated response containing all the media items in that specific workspace. This is helpful for retrieving a large volume of media and managing content in bulk.

Example

If you manage a video platform and need to review all uploaded media in your library to ensure that outdated or low-quality content isn’t being served, you can use this endpoint to retrieve a complete list of media. You can then filter, sort, or update items as needed.

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

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.

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

1	{
2	"success": true,
3	"data": [
4	{
5	"thumbnail": "https://images.fastpix.com/837f028b-dcaf-4c23-b368-3748641f74ac/thumbnail.png",
6	"id": "cfeec1a3-6cbd-40df-a425-2ed7f8f72ced",
7	"workspaceId": "6dc2b4e0-0615-42fd-a580-1f4aad932dfe",
8	"metadata": {
9	"key1": "value1"
10	},
11	"mediaQuality": "standard",
12	"maxResolution": "1080p",
13	"sourceResolution": "1080p",
14	"status": "Ready",
15	"sourceAccess": false,
16	"playbackIds": [
17	{
18	"id": "837f028b-dcaf-4c23-b368-3748641f74ac",
19	"accessPolicy": "public",
20	"accessRestrictions": {
21	"domains": {
22	"defaultPolicy": "allow",
23	"allow": [],
24	"deny": []
25	},
26	"userAgents": {
27	"defaultPolicy": "allow",
28	"allow": [],
29	"deny": []
30	}
31	}
32	}
33	],
34	"tracks": [
35	{
36	"id": "f301a2a1-b40d-40fa-b419-4d0cd92a62f8",
37	"type": "video",
38	"width": 1920,
39	"height": 1080,
40	"status": "available"
41	}
42	],
43	"generatedSubtitles": [],
44	"isAudioOnly": false,
45	"subtitleAvailable": true,
46	"duration": "00:00:10",
47	"aspectRatio": "16:9",
48	"createdAt": "2025-01-09T06:44:44.617138Z",
49	"updatedAt": "2025-01-09T06:44:53.742648Z"
50	}
51	],
52	"pagination": {
53	"totalRecords": 100,
54	"currentOffset": 1,
55	"offsetCount": 10
56	}
57	}