License images

POST {{baseUrl}}/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.

Request Params

KeyDatatypeRequiredDescription
subscription_idstringSubscription ID to use to license the image
formatstringImage format
sizestringImage size
search_idstringSearch ID that was provided in the results of an image search

Request Body

{"images"=>[{"image_id"=>"<string>", "auth_cookie"=>{"name"=>"<string>", "value"=>"<string>"}, "editorial_acknowledgement"=>"<boolean>", "format"=>"<string>", "metadata"=>{}, "price"=>"<number>", "search_id"=>"<string>", "show_modal"=>"<boolean>", "size"=>"<string>", "custom_dimensions"=>{"height"=>"<integer>", "width"=>"<integer>"}, "subscription_id"=>"<string>", "verification_code"=>"<string>"}, {"image_id"=>"<string>", "auth_cookie"=>{"name"=>"<string>", "value"=>"<string>"}, "editorial_acknowledgement"=>"<boolean>", "format"=>"<string>", "metadata"=>{}, "price"=>"<number>", "search_id"=>"<string>", "show_modal"=>"<boolean>", "size"=>"<string>", "custom_dimensions"=>{"height"=>"<integer>", "width"=>"<integer>"}, "subscription_id"=>"<string>", "verification_code"=>"<string>"}]}

HEADERS

KeyDatatypeRequiredDescription
User-Agentstring

RESPONSES

status: OK

{&quot;data&quot;:[{&quot;image_id&quot;:&quot;547233985&quot;,&quot;download&quot;:{&quot;url&quot;:&quot;https://download.shutterstock.com/gatekeeper/[random-characters]/shutterstock_547233985.jpg&quot;},&quot;allotment_charge&quot;:1}]}