---
title: "License images"
method: POST
path: "/v2/images/licenses"
tags: ["images"]
---

# License images

`POST /v2/images/licenses`

This endpoint gets licenses for one or more images. You must specify the image IDs in the body parameter and other details like the format, size, and subscription ID either in the query parameter or with each image ID in the body parameter. Values in the body parameter override values in the query parameters. The download links in the response are valid for 8 hours.

## Query parameters

- `subscription_id` string
- `format` 'eps' | 'jpg'
- `size` 'small' | 'medium' | 'huge' | 'vector' | 'custom'
- `search_id` string

## Request body

- object — Image license request data
  - `images` union[], required — Images to create licenses for
    - union
      - object — Data required to license an image
        - `auth_cookie` object — Cookie object
          - `name` string, required — The name of the cookie
          - `value` string, required — The value of the cookie
        - `editorial_acknowledgement` boolean — Set to true to acknowledge the editorial agreement
        - `format` 'jpg' — (Deprecated) Image format to download
        - `image_id` string, required — Image ID
        - `metadata` object — Additional information for license requests for enterprise accounts and API subscriptions, 4 fields maximum; which fields are required is set by the account holder
        - `price` number — For revenue-sharing transactions, the final cost to the end customer as a floating-point number in the transaction currency, such as 12.34
        - `search_id` string — ID of the search that led to this licensing transaction
        - `show_modal` boolean — (Deprecated)
        - `size` 'small' | 'medium' | 'huge' | 'custom' — Image size to download
        - `custom_dimensions` object — A custom height or a custom width to resize the image to, but not both (experimental)
          - `height` integer — Custom height to resize the image to
          - `width` integer — Custom width to resize the image to
        - `subscription_id` string — ID of the subscription to use for the download.
        - `verification_code` string — (Deprecated)
      - object — Data required to license an image
        - `auth_cookie` object — Cookie object
          - `name` string, required — The name of the cookie
          - `value` string, required — The value of the cookie
        - `editorial_acknowledgement` boolean — Set to true to acknowledge the editorial agreement
        - `format` 'eps' — (Deprecated) Image format to download
        - `image_id` string, required — Image ID
        - `metadata` object — Additional information for license requests for enterprise accounts and API subscriptions, 4 fields maximum; which fields are required is set by the account holder
        - `price` number — For revenue-sharing transactions, the final cost to the end customer as a floating-point number in the transaction currency, such as 12.34
        - `search_id` string — ID of the search that led to this licensing transaction
        - `show_modal` boolean — (Deprecated)
        - `size` 'vector' — Image size to download
        - `subscription_id` string — ID of the subscription to use for the download.
        - `verification_code` string — (Deprecated)

## Response `200`

OK

- object — List of information about licensed images
  - `data` object[] — License results
    - `allotment_charge` integer — Number of credits that this licensing event used
    - `download` object — Information that is needed to download the image
      - `url` string, required — URL that can be used to download the unwatermarked, licensed asset
    - `error` string — Error message, appears only if there was an error
    - `image_id` string, required — Image ID that was licensed
    - `license_id` string — ID of the license event
    - `price` object — Wholesale price information; only for rev-share partners
      - `local_amount` number — Floating-point amount of the calculated rev-share price in the currency local_currency
      - `local_currency` string — Currency of the rev-share price that was calculated
  - `errors` object[] — Error list; appears only if there was an error
    - `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 — Current page that is returned
  - `per_page` integer — Number of results per page
  - `total_count` integer — Total count of all results across all pages

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/shutterstock/apis/shutterstock-api-explorer.md) · [All operations](https://skmtc.net/shutterstock/apis/shutterstock-api-explorer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shutterstock/shutterstock-api-explorer/versions/d2e03e7f655d/schema)