---
updatedAt: 2026-09-21T22:06:18.000Z
agentTools:
  siteIndex: https://docs.jwplayer.com/llms.txt
  projectIndex: https://docs.jwplayer.com/platform/llms.txt
---

# Retrieve list of custom video renditions

Retrieves a list of custom video renditions

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "servers": [
    {
      "url": "https://api.jwplayer.com"
    }
  ],
  "info": {
    "version": "0.2",
    "title": "Management API v2",
    "description": "Customer-facing management API. This file only includes documented routes."
  },
  "security": [
    {
      "v2ApiSecret": []
    }
  ],
  "x-explorer-enabled": true,
  "x-proxy-enabled": true,
  "x-samples-enabled": true,
  "x-samples-languages": [
    "python",
    "node",
    "ruby",
    "php",
    "go",
    "java",
    "csharp"
  ],
  "paths": {
    "/v2/sites/{site_id}/media/{media_id}/custom_video_renditions/": {
      "get": {
        "summary": "Retrieve list of custom video renditions",
        "description": "Retrieves a list of custom video renditions",
        "parameters": [
          {
            "$ref": "#/components/parameters/siteId"
          },
          {
            "$ref": "#/components/parameters/mediaId"
          },
          {
            "$ref": "#/components/parameters/pageParam"
          },
          {
            "$ref": "#/components/parameters/pageLengthParam"
          },
          {
            "name": "sort",
            "description": "Allows for sorting results\n\nExample: `sort=size:asc`\n\nSort order can be `asc` or `dsc`. Additionally, custom video renditions can be sorted by the following attributes:\n  - `size`\n  - `codec`\n  - `width`\n  - `height`\n",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "custom renditions"
        ],
        "responses": {
          "200": {
            "description": "Custom Video Rendition Resources",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CustomVideoRenditionResources"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "parameters": {
      "siteId": {
        "name": "site_id",
        "description": "Unique alphanumeric ID of the site",
        "in": "path",
        "required": true,
        "schema": {
          "$ref": "#/components/schemas/ResourceId"
        }
      },
      "mediaId": {
        "name": "media_id",
        "description": "Unique alphanumeric ID of the media",
        "in": "path",
        "required": true,
        "schema": {
          "$ref": "#/components/schemas/ResourceId"
        }
      },
      "pageParam": {
        "name": "page",
        "description": "Sets the page number for pagination. First page is `1`.",
        "in": "query",
        "required": false,
        "schema": {
          "type": "integer",
          "default": 1
        }
      },
      "pageLengthParam": {
        "name": "page_length",
        "description": "Sets the page length (number of items you get in the response) for pagination\n\nIf `page_length` is not specified, the default value will be set.\n\nDefault: `10`\n",
        "in": "query",
        "required": false,
        "schema": {
          "type": "integer",
          "default": 10
        }
      }
    },
    "schemas": {
      "ResourceId": {
        "description": "Unique identifier for a resource",
        "type": "string",
        "minLength": 8,
        "maxLength": 8,
        "example": "Ny05CEfj",
        "pattern": "^[A-Za-z0-9]+$"
      },
      "ResourcesRead": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer",
            "description": "Offset for returned resources",
            "example": 1
          },
          "page_length": {
            "type": "integer",
            "description": "Maximum number of resources to return",
            "example": 10
          },
          "total": {
            "type": "integer",
            "description": "Number of resources available before pagination",
            "example": 1
          }
        }
      },
      "CustomVideoRenditionResources": {
        "allOf": [
          {
            "$ref": "#/components/schemas/ResourcesRead"
          },
          {
            "type": "object",
            "properties": {
              "video_renditions": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/CustomVideoRenditionResource"
                }
              }
            }
          }
        ]
      },
      "CustomVideoRenditionResource": {
        "type": "object",
        "properties": {
          "id": {
            "description": "Unique identifier for a resource",
            "type": "string",
            "example": "aBcD1234"
          },
          "status": {
            "description": "Custom rendition status",
            "type": "string",
            "enum": [
              "created",
              "processing",
              "ready",
              "failed"
            ]
          },
          "error_message": {
            "description": "A human-readable error message for describing failures",
            "type": "string"
          },
          "created": {
            "description": "Date and time at which the resource was created in JWX",
            "type": "string",
            "format": "date-time",
            "example": "2018-10-02T21:19:36.602019+00:00"
          },
          "last_modified": {
            "description": "Date and time at which the resource was most recently modified",
            "type": "string",
            "format": "date-time",
            "example": "2018-10-02T21:19:36.602019+00:00"
          },
          "width": {
            "type": "integer"
          },
          "height": {
            "type": "integer"
          },
          "size": {
            "type": "integer",
            "description": "Size of the custom video rendition, in bytes"
          },
          "codec": {
            "type": "string"
          },
          "frame_rate": {
            "type": "number"
          },
          "bit_rate": {
            "type": "integer",
            "description": "Bit rate of the custom video rendition in bits per second"
          },
          "transcode": {
            "description": "Source track and settings the rendition was transcoded from, or `null` if the rendition was uploaded rather than transcoded.\n",
            "type": "object",
            "nullable": true,
            "properties": {
              "original_id": {
                "description": "ID of the original that the source track belongs to",
                "type": "string",
                "example": "aBcD1234"
              },
              "video_track_id": {
                "description": "ID of the video track the rendition was transcoded from",
                "type": "string",
                "example": "aBcD1234"
              },
              "settings": {
                "$ref": "#/components/schemas/CustomVideoRenditionTranscodeSettings"
              }
            }
          }
        }
      },
      "CustomVideoRenditionTranscodeSettings": {
        "description": "Output settings for the transcoded video rendition",
        "type": "object",
        "properties": {
          "codec": {
            "description": "Video codec of the rendition. `hevc` and `av1` are only available with premium tier; without it the rendition is not created.\n",
            "type": "string",
            "enum": [
              "h264",
              "hevc",
              "av1"
            ]
          },
          "width": {
            "description": "Width of the rendition, in pixels",
            "type": "integer",
            "minimum": 1,
            "maximum": 3840,
            "example": 1920
          },
          "height": {
            "description": "Height of the rendition, in pixels",
            "type": "integer",
            "minimum": 1,
            "maximum": 2160,
            "example": 1080
          },
          "frame_rate": {
            "description": "Frame rate of the rendition",
            "type": "number",
            "maximum": 120,
            "example": 29.97
          },
          "quality": {
            "description": "Quality level of the rendition. Higher levels target a higher quality at the cost of a higher bitrate.\n",
            "type": "integer",
            "minimum": 1,
            "maximum": 9
          }
        },
        "required": [
          "codec"
        ]
      }
    },
    "securitySchemes": {
      "v2ApiSecret": {
        "description": "V2 API secret used for authentication",
        "type": "apiKey",
        "in": "header",
        "name": "Authorization"
      }
    }
  }
}
```

# Sibling pages

* [Create a custom video rendition](https://docs.jwplayer.com/platform/reference/post_v2-sites-site-id-media-media-id-cmaf-vod-video-renditions.md)
* [Retrieve a custom video rendition](https://docs.jwplayer.com/platform/reference/get_v2-sites-site-id-media-media-id-cmaf-vod-video-renditions-rendition-id.md)
* [Delete a custom video rendition](https://docs.jwplayer.com/platform/reference/delete_v2-sites-site-id-media-media-id-cmaf-vod-video-renditions-rendition-id.md)