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

# License generated images

`POST /v2/generative/images/licenses`

## Request

- Base URL: `https://api.shutterstock.com`
- URL: `https://api.shutterstock.com/v2/generative/images/licenses`
- Auth: OAuth 2
  - Authorization code: `https://accounts.shutterstock.com/oauth/authorize`
  - Token URL: `https://api.shutterstock.com/v2/oauth/access_token` scopes: `licenses.create`, `purchases.view`
- TypeScript: <https://skmtc.dev/shutterstock/apis/shutterstock-api-explorer/docs/v2/generative/images/licenses/post.ts> (a function with typed inputs; its response is checked against the schema)

Registers generated image assets and licenses the registered images.

## Query parameters

- `subscription_id` string
- `size` 'small' | 'medium' | 'huge' | 'custom'

## Request body

- object: Generated image license request data.
  - `images` object[], required: Generated image assets to register and license.
    - `asset_id` string, required: Generated image asset ID returned in the generative image result asset list.
    - `ai_use_acknowledgement` boolean, required: This must be set to true to license this asset. It confirms: I acknowledge that AI-generated content is not reviewed by Shutterstock's content compliance team for intellectual property compliance unless otherwise stated, and should not be used publicly if it contains the likeness of a brand, public personality, or other protected content.
    - `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
    - `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.

## Response `200`

OK

- object: List of generated image licensing results.
  - `data` object[], required: License results.
    - `asset_id` string, required: Generated image asset ID requested for licensing.
    - `image_id` string: Registered Shutterstock image ID that was licensed, or that failed to license if registration succeeded before licensing failed.
    - `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.
    - `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
      - `content_tiers` object: Prices by content tier
  - `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, required: Server-generated message about the licensing request.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too Many Requests
- `500`: Internal Server Error
- `503`: Service Unavailable

## Changes

- **2026-10-14** `b43cab3aaaaa`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/shutterstock/apis/shutterstock-api-explorer/changes/v2/generative/images/licenses/post.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)