---
title: "Endpoint for acquiring extended licenses with iStock credits for an asset."
method: POST
path: "/v3/asset-licensing/{assetId}"
tags: ["AssetLicensing"]
---

# Endpoint for acquiring extended licenses with iStock credits for an asset.

`POST /v3/asset-licensing/{assetId}`

## Request

- Base URL: `https://api.gettyimages.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.gettyimages.com/v3/asset-licensing/{assetId}`
- Auth: one of:
  - API key in header `Api-Key`
  - OAuth 2
    - Authorization code: `https://authentication.gettyimages.com/oauth2/auth`
    - Client credentials
    - Password
    - Token URL: `https://authentication.gettyimages.com/oauth2/token`
- TypeScript: <https://skmtc.dev/gettyimages/apis/getty-images-api/docs/v3/asset-licensing/:assetId/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `assetId` string, required

## Headers

- `Accept-Language` string: Provide a header to specify the language of result values. Supported values: cs (iStock only), de, en-GB, en-US, es, fi (iStock only), fr, hu (iStock only), id (iStock only), it, ja, ko (creative assets only), nl, pl (creative assets only), pt-BR, pt-PT, ro (iStock only), ru (creative assets only), sv, th (iStock only), tr, uk (iStock only), vi (iStock only), zh-HK (creative assets only).

## Request body

- GettyImagesServicesConnectPublicControllersAssetLicensingAcquireAssetLicensesRequest
  - `extended_licenses` GettyImagesServicesConnectPublicControllersAssetLicensingExtendedLicenses[], required
  - `use_team_credits` boolean: Defaults to false.

## Response `200`

OK

- GettyImagesServicesConnectPublicControllersAssetLicensingAssetLicensingResponse
  - `credits_used` integer
  - `acquired_licenses` GettyImagesServicesConnectPublicControllersAssetLicensingExtendedLicenses[], nullable

## Other responses

- `400`: InvalidRequestParameters
- `401`: AuthorizationTokenRequired
- `402`: NotEnoughCreditsForPurchase
- `404`: StandardLicenseNotFound

---

[API](https://skmtc.dev/gettyimages/apis/getty-images-api.md) - [All operations](https://skmtc.dev/gettyimages/apis/getty-images-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gettyimages/apis/getty-images-api/revisions/f20ce986456b?raw)