editorial_video

List editorial video licenses

Changed on Oct 14, 2026

This endpoint lists existing editorial video licenses.

get/v2/editorial/videos/licenses

Request

Base URL
https://api.shutterstock.com
Auth
OAuth 2
Authorization codehttps://accounts.shutterstock.com/oauth/authorize
Token URLhttps://api.shutterstock.com/v2/oauth/access_token
Scopeslicenses.view
TypeScript
https://skmtc.dev/shutterstock/apis/shutterstock-api-explorer/docs/v2/editorial/videos/licenses/get.ts
A function with typed inputs. Its response is checked against the schema.

Query parameters

video_idstring

Show licenses for the specified editorial video ID

licensestring

Show editorial videos that are available with the specified license name

pageinteger

Page number

per_pageinteger

Number of results per page

sort'newest' | 'oldest'

Sort order

usernamestring

Filter licenses by username of licensee

start_datestring date-time

Show licenses created on or after the specified date

end_datestring date-time

Show licenses created before the specified date

download_availability'all' | 'downloadable' | 'non_downloadable'

Filter licenses by download availability

team_historyboolean

Set to true to see license history for all members of your team.

Response

messagestring

Server-generated message, if any

pageinteger

The current page of results

per_pageinteger

The number of results per page

total_countinteger

The total number of results across all pages

Example response

{
  "total_count": 2890,
  "page": 1,
  "per_page": 1,
  "data": [
    {
      "id": "e1eba3833793e77188d22caae8bac9f2cd",
      "user": {
        "username": "editorial_test_account_002"
      },
      "license": "premier_editorial_all_digital",
      "download_time": "2021-07-15T15:46:34.000Z",
      "is_downloadable": false,
      "image": {
        "id": "9763363ao",
        "generation_id": "0136648a-d739-4c00-8af9-92b1a31db567",
        "generation_asset_id": "asset-generation-0136648a-d739-4c00-8af9-92b1a31db567-0",
        "generated_by_user": 1234,
        "ai_ip_review": {
          "status": "pending",
          "rejection_reasons": []
        },
        "format": {
          "size": "original"
        }
      },
      "subscription_id": "s12345678",
      "metadata": {
        "purchase_order": "123456",
        "client": "Company A",
        "job": "Important project",
        "other": "Important media"
      }
    }
  ]
}

Changes

Oct 14, 2026b43cab3aaaaa Revision changes
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property // to the response with the status
Jul 13, 2026d2e03e7f655d Revision changes
- info
  endpoint added

Operation history