--- title: "List editorial video licenses" method: GET path: "/v2/editorial/videos/licenses" tags: ["editorial_video"] --- # List editorial video licenses `GET /v2/editorial/videos/licenses` ## Request - Base URL: `https://api.shutterstock.com` - URL: `https://api.shutterstock.com/v2/editorial/videos/licenses` - Auth: OAuth 2 - Authorization code: `https://accounts.shutterstock.com/oauth/authorize` - Token URL: `https://api.shutterstock.com/v2/oauth/access_token` scopes: `licenses.view` - TypeScript: (a function with typed inputs; its response is checked against the schema) This endpoint lists existing editorial video licenses. ## Query parameters - `video_id` string - `license` string - `page` integer - `per_page` integer - `sort` 'newest' | 'oldest' - `username` string - `start_date` string, date-time - `end_date` string, date-time - `download_availability` 'all' | 'downloadable' | 'non_downloadable' - `team_history` boolean ## Response `200` OK - object: List of download events - `data` object[]: Download events - `audio` object: Information about the downloaded media - `ai_ip_review` object: AI IP review information for a generated image. Returned only when available for the downloaded generated image. - `rejection_reasons` string[]: Reasons the AI-generated image was rejected during IP review - `status` string: Current status of the AI-generated image IP review process - `format` object: Information about the format of a download - `format` string: The format of the downloaded media - `size` string: The size of the downloaded media - `generated_by_user` integer: ID of the user who generated the AI image. Returned only for generated image license history when available. - `generation_asset_id` string: Generated asset ID associated with the licensed image. Returned only for generated image license history when available. - `generation_id` string: Generation request UUID associated with the licensed image. Returned only for generated image license history when available. - `id` string, required: ID of the download history media details - `is_ai_generated` boolean: Whether the licensed image is AI generated. Returned for image license history. - `download_time` string, date-time, required: Date the media was downloaded the first time - `id` string, required: ID of the download - `image` object: Information about the downloaded media - `ai_ip_review` object: AI IP review information for a generated image. Returned only when available for the downloaded generated image. - `rejection_reasons` string[]: Reasons the AI-generated image was rejected during IP review - `status` string: Current status of the AI-generated image IP review process - `format` object: Information about the format of a download - `format` string: The format of the downloaded media - `size` string: The size of the downloaded media - `generated_by_user` integer: ID of the user who generated the AI image. Returned only for generated image license history when available. - `generation_asset_id` string: Generated asset ID associated with the licensed image. Returned only for generated image license history when available. - `generation_id` string: Generation request UUID associated with the licensed image. Returned only for generated image license history when available. - `id` string, required: ID of the download history media details - `is_ai_generated` boolean: Whether the licensed image is AI generated. Returned for image license history. - `is_downloadable` boolean: Specifies if the media is downloadable via its respective downloads endpoint - `license` string, required: The name of the license of this download - `metadata` object: The metadata that was passed in the original licensing request - `subscription_id` string: ID of the subscription used to perform this download - `user` object: Information about a user - `username` string, required: The name of the user who downloaded the item - `video` object: Information about the downloaded media - `ai_ip_review` object: AI IP review information for a generated image. Returned only when available for the downloaded generated image. - `rejection_reasons` string[]: Reasons the AI-generated image was rejected during IP review - `status` string: Current status of the AI-generated image IP review process - `format` object: Information about the format of a download - `format` string: The format of the downloaded media - `size` string: The size of the downloaded media - `generated_by_user` integer: ID of the user who generated the AI image. Returned only for generated image license history when available. - `generation_asset_id` string: Generated asset ID associated with the licensed image. Returned only for generated image license history when available. - `generation_id` string: Generation request UUID associated with the licensed image. Returned only for generated image license history when available. - `id` string, required: ID of the download history media details - `is_ai_generated` boolean: Whether the licensed image is AI generated. Returned for image license history. - `revshare` object: Pricing information for revenue-sharing transactions - `purchase_amount` string, required: The amount charged for the license - `purchase_currency` string, required: The currency the amount was charged in - `errors` object[]: Error list; appears only if there was an error - `statusCode` number: HTTP Error code - `code` string: The error code of this error - `data` string: Debugging information about the error - `items` object[]: A list of items that produced the error - `message` string, required: Specific details about this error - `path` string: Internal code reference to the source of the error - `message` string: Server-generated message, if any - `page` integer: The current page of results - `per_page` integer: The number of results per page - `total_count` integer: The total number of results across all pages ## Other responses - `400`: Bad Request - `401`: Unauthorized - `403`: Forbidden ## Changes - **2026-10-14** `b43cab3aaaaa`: 16 info - added the optional property `data/items/audio/ai_ip_review` to the response with the `200` status - added the optional property `data/items/audio/generated_by_user` to the response with the `200` status - added the optional property `data/items/audio/generation_asset_id` to the response with the `200` status - added the optional property `data/items/audio/generation_id` to the response with the `200` status - …12 more - **2026-07-13** `d2e03e7f655d`: 1 info - endpoint added [Operation history](https://skmtc.dev/shutterstock/apis/shutterstock-api-explorer/changes/v2/editorial/videos/licenses/get.md) --- [API](https://skmtc.dev/shutterstock/apis/shutterstock-api-explorer.md) - [All operations](https://skmtc.dev/shutterstock/apis/shutterstock-api-explorer/llms.txt) - [OpenAPI document](https://skmtc.dev/shutterstock/apis/shutterstock-api-explorer/revisions/b43cab3aaaaa?raw)