List licenses

GET https://api.shutterstock.com/v2/images/licenses
Parameters
Name Type Description
image_id string Restrict results by image ID.
license string Restrict results by license. Prepending a - sign will exclude results by license.
page integer Page number. Minimum: 1. Default: 1.
per_page integer Number of results per page. Range: 0 - 200. Default: 20.
sort string Sort order. Supports: newest, oldest. Default: newest.
Response Codes
  • 200 OK
  • 400 Bad Request
Required Scopes
  • customer: licenses.view
Example Request
GET https://api.shutterstock.com/v2/images/licenses?per_page=1
Example Response
{
  "data": [
    {
      "id": "i2802362546",
      "user": {
        "username": "ntf"
      },
      "license": "comp",
      "download_time": "2016-08-18T18:53:19-04:00",
      "image": {
        "id": "117697474",
        "format": {
          "size": "huge"
        }
      }
    }
  ],
  "page": 1,
  "per_page": 1
}
Response {
data (DownloadHistory[], optional),
page (integer, optional),
per_page (integer, optional),
total_count (integer, optional),
message (string, optional),
errors (Error[], optional)
}
DownloadHistory {
id (string),
license (string),
download_time (string),
subscription_id (string, optional),
is_downloadable (boolean, optional),
user (DownloadHistoryUserDetails, optional),
metadata (object, optional),
audio (DownloadHistoryMediaDetails, optional),
image (DownloadHistoryMediaDetails, optional),
video (DownloadHistoryMediaDetails, optional)
}
Error {
code (string, optional),
data (string, optional),
message (string),
path (string, optional),
items (object[], optional)
}
DownloadHistoryUserDetails {
username (string)
}
DownloadHistoryMediaDetails {
id (string),
format (DownloadHistoryFormatDetails, optional)
}
DownloadHistoryFormatDetails {
size (string, optional),
format (string, optional)
}