openapi-directory/api/gettyimages.com.json

Building & bundling https://github.com/APIs-guru/openapi-directory for easy use from JS

{"openapi":"3.0.1","info":{"title":"Getty Images","version":"3","x-apisguru-categories":["media"],"x-logo":{"url":"http://developers.gettyimages.com/images/getty-api-logo.jpg"},"x-origin":[{"format":"openapi","url":"https://api.gettyimages.com/swagger/v3/swagger.json","version":"3.0"}],"x-providerName":"gettyimages.com"},"security":[{"Api-Key":[]},{"OAuth2":[]}],"paths":{"/v3/affiliates/search/images":{"get":{"parameters":[{"description":"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).","in":"header","name":"Accept-Language","schema":{"description":"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).","type":"string"}},{"description":"Search images using a search phrase.","in":"query","name":"phrase","schema":{"description":"Search images using a search phrase.","nullable":true,"type":"string"}},{"description":"Filter based on graphical style of the image.","in":"query","name":"style","schema":{"$ref":"#/components/schemas/AffiliateSearchStyle"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AffiliateImageSearchResponse"}}},"description":"Success"}},"summary":"","tags":["AffiliateSearch"]}},"/v3/affiliates/search/videos":{"get":{"parameters":[{"description":"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).","in":"header","name":"Accept-Language","schema":{"description":"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).","type":"string"}},{"in":"query","name":"phrase","schema":{"nullable":true,"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AffiliateVideoSearchResponse"}}},"description":"Success"}},"tags":["AffiliateSearch"]}},"/v3/artists/images":{"get":{"parameters":[{"description":"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).","in":"header","name":"Accept-Language","schema":{"description":"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).","type":"string"}},{"description":"Name of artist for desired images","in":"query","name":"artist_name","schema":{"description":"Name of artist for desired images","nullable":true,"type":"string"}},{"description":"Comma separated list of fields. Allows restricting which fields are returned. If no fields are selected, the summary_set of fields are returned.","explode":false,"in":"query","name":"fields","schema":{"description":"Comma separated list of fields. Allows restricting which fields are returned. If no fields are selected, the summary_set of fields are returned.","items":{"$ref":"#/components/schemas/ArtistsImageSearchFieldValues"},"nullable":true,"type":"array"},"style":"form"},{"description":"Identifies page to return. Default page is 1.","in":"query","name":"page","schema":{"default":1,"description":"Identifies page to return. Default page is 1.","format":"int32","type":"integer"}},{"description":"Specifies page size. Default page_size is 10, maximum page_size is 100.","in":"query","name":"page_size","schema":{"default":10,"description":"Specifies page size. Default page_size is 10, maximum page_size is 100.","format":"int32","type":"integer"}}],"responses":{"200":{"description":"OK"},"400":{"description":"InvalidParameterValue"},"401":{"description":"Unauthorized"}},"summary":"Search for images by a photographer","tags":["Artists"]}},"/v3/artists/videos":{"get":{"parameters":[{"description":"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).","in":"header","name":"Accept-Language","schema":{"description":"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).","type":"string"}},{"description":"Name of artist for desired images","in":"query","name":"artist_name","schema":{"description":"Name of artist for desired images","nullable":true,"type":"string"}},{"description":"Comma separated list of fields. Allows restricting which fields are returned. If no fields are selected, the summary_set of fields are returned.","explode":false,"in":"query","name":"fields","schema":{"description":"Comma separated list of fields. Allows restricting which fields are returned. If no fields are selected, the summary_set of fields are returned.","items":{"$ref":"#/components/schemas/ArtistsVideoSearchFieldValues"},"nullable":true,"type":"array"},"style":"form"},{"description":"Identifies page to return. Default page is 1.","in":"query","name":"page","schema":{"default":1,"description":"Identifies page to return. Default page is 1.","format":"int32","type":"integer"}},{"description":"Specifies page size. Default page_size is 10, maximum page_size is 100.","in":"query","name":"page_size","schema":{"default":10,"description":"Specifies page size. Default page_size is 10, maximum page_size is 100.","format":"int32","type":"integer"}}],"responses":{"200":{"description":"OK"},"400":{"description":"InvalidParameterValue"},"401":{"description":"Unauthorized"}},"summary":"Search for videos by a photographer","tags":["Artists"]}},"/v3/asset-changes/change-sets":{"put":{"description":"# Asset Changes\n\nGet notifications about new, updated or deleted assets for a specific channel.\n\n##  Quickstart\n\nYou'll need an API key and an access token to use this resource. \n\nMaximum batch size is 2200.\n\nChange-sets must be confirmed before a new batch of notifications can be retrieved from this endpoint. Use the DELETE asset-changes/change-sets/{change-set-id} endpoint to confirm reciept of these notifications.\n\nValues returned for asset_type include Image, Film, and null. Values returned for asset_lifecycle include New, Update, and Delete.\n\nDelete notifications may be provided for asset ids that have not previously been received as New or Update notifications. Delete notifications may return null for the asset_type.\n\nIf there are no notifications in the channel an empty response body will be returned.\n\nNotifications older than 60 days will be removed from partner channels.\n","parameters":[{"description":"Specifies the id of the channel for the asset data. Valid channel ids can be found in the results of the Get Partner Channel query.","in":"query","name":"channel_id","schema":{"description":"Specifies the id of the channel for the asset data. Valid channel ids can be found in the results of the Get Partner Channel query.","format":"int32","type":"integer"}},{"description":"Specifies the number of assets to return. The default is 2200; maximum is 2200.","in":"query","name":"batch_size","schema":{"description":"Specifies the number of assets to return. The default is 2200; maximum is 2200.","format":"int32","nullable":true,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetChanges"}}},"description":"Success - Channel contains unconfirmed asset change notifications"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetChanges"}}},"description":"Created"},"400":{"description":"InvalidChannelIdException"},"403":{"description":"Your access token does not authorize access to this resource"},"404":{"description":"The channel you specified does not exist"}},"summary":"Get asset change notifications.","tags":["AssetChanges"]}},"/v3/asset-changes/change-sets/{change-set-id}":{"delete":{"description":"# Delete Asset Changes\n\nConfirm asset changes acknowledges receipt of asset changes (from the PUT asset-changes endpoint).\n\n##  Quickstart\n\nYou'll need an API key and an access token to use this resource.\n\nUse the change_set_id from the PUT asset-changes/change-sets endpoint to confirm receipt of notifications.\n","parameters":[{"description":"Specify the change-set-id associated with a transaction resource whose receipt you want to confirm.","in":"path","name":"change-set-id","required":true,"schema":{"description":"Specify the change-set-id associated with a transaction resource whose receipt you want to confirm.","format":"int64","type":"integer"}}],"responses":{"200":{"description":"Success"},"400":{"description":"InvalidChangeSetId"},"403":{"description":"Your access token does not authorize access to this resource"},"404":{"description":"Transaction was not found"}},"summary":"Confirm asset change notifications.","tags":["AssetChanges"]}},"/v3/asset-changes/channels":{"get":{"description":"# Get Partner Channels\n\nRetrieves the channel data for the partner. This data can be used to populate the channel_id parameter in the Put Asset Changes query.\n\n##  Quickstart\n\nYou'll need an API key and an access token to use this resource.\n\nPartners who have a channel that has been removed should contact their sales representative to be set up again.\n\n","responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/Channel"},"type":"array"}}},"description":"Success"},"403":{"description":"UnauthorizedToAccessResource"},"404":{"description":"ChannelsNotFound"}},"summary":"Get a list of asset change notification channels.","tags":["AssetChanges"]}},"/v3/asset-licensing/{assetId}":{"post":{"parameters":[{"description":"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).","in":"header","name":"Accept-Language","schema":{"description":"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).","type":"string"}},{"description":"Getty Images assetId - examples 520621493, 112301284","in":"path","name":"assetId","required":true,"schema":{"description":"Getty Images assetId - examples 520621493, 112301284","nullable":true,"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AcquireAssetLicensesRequest"}}},"description":"Structure that specifies an array of LicenseTypes (multiseat, unlimited, resale, indemnification) to acquire,\r\n            and whether or not to use Team Credits. Authenticated User must have access to Team Credits if UseTeamCredits is set to \"true\"."},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetLicensingResponse"}}},"description":"Success"},"400":{"description":"InvalidRequestParameters"},"401":{"description":"AuthorizationTokenRequired"},"402":{"description":"NotEnoughCreditsForPurchase"},"404":{"description":"StandardLicenseNotFound"}},"summary":"Endpoint for acquiring extended licenses with iStock credits for an asset.","tags":["AssetLicensing"]}},"/v3/asset-management/assets/send-events":{"get":{"parameters":[{"description":"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).","in":"header","name":"Accept-Language","schema":{"description":"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).","type":"string"}},{"description":"Specifies a date/time (with timezone information) for continuing retrieval of events.\r\nEvents occuring _after_ the `last_offset` value provided will be returned.","in":"query","name":"last_offset","schema":{"description":"Specifies a date/time (with timezone information) for continuing retrieval of events.\r\nEvents occuring _after_ the `last_offset` value provided will be returned.","format":"date-time","nullable":true,"type":"string"}},{"description":"Specifies the number of events to return. Default is 50, maximum value is 100.","in":"query","name":"event_count","schema":{"description":"Specifies the number of events to return. Default is 50, maximum value is 100.","format":"int32","nullable":true,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetSendEventsResponse"}},"text/json":{"schema":{"$ref":"#/components/schemas/GetSendEventsResponse"}},"text/plain":{"schema":{"$ref":"#/components/schemas/GetSendEventsResponse"}}},"description":"Success"},"400":{"description":"EventCountOutOfRange"}},"tags":["AssetManagement"]}},"/v3/boards":{"get":{"parameters":[{"description":"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).","in":"header","name":"Accept-Language","schema":{"description":"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).","type":"string"}},{"description":"Request results starting at a page number (default is 1).","in":"query","name":"page","schema":{"default":1,"description":"Request results starting at a page number (default is 1).","format":"int32","type":"integer"}},{"description":"Search for boards the user owns or has been invited to as an editor.","in":"query","name":"board_relationship","schema":{"$ref":"#/components/schemas/BoardRelationship"}},{"description":"Sort the list of boards by last update date or name. Defaults to date_last_updated_descending.","in":"query","name":"sort_order","schema":{"$ref":"#/components/schemas/BoardSortOrder"}},{"description":"Request number of boards to return in each page. (default is 30).","in":"query","name":"pageSize","schema":{"default":30,"description":"Request number of boards to return in each page. (default is 30).","format":"int32","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BoardList"}}},"description":"Success"},"400":{"description":"InvalidParameterValue"},"401":{"description":"Unauthorized"}},"summary":"Get all boards that the user participates in","tags":["Boards"]},"post":{"parameters":[{"description":"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).","in":"header","name":"Accept-Language","schema":{"description":"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).","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BoardInfo"}}},"description":"Specify a name and description of the board to create (name is required)."},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BoardCreated"}}},"description":"Created"},"400":{"description":"InvalidParameterValue"},"401":{"description":"Unauthorized"}},"summary":"Create a new board","tags":["Boards"]}},"/v3/boards/{board_id}":{"delete":{"parameters":[{"description":"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).","in":"header","name":"Accept-Language","schema":{"description":"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).","type":"string"}},{"description":"Specify the board to delete.","in":"path","name":"board_id","required":true,"schema":{"description":"Specify the board to delete.","nullable":true,"type":"string"}}],"responses":{"200":{"description":"Success"},"204":{"description":""},"400":{"description":"InvalidParameterValue"},"401":{"description":"Unauthorized"},"403":{"description":"InsufficientAccess"},"404":{"description":"BoardNotFound"}},"summary":"Delete a board","tags":["Boards"]},"get":{"parameters":[{"description":"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).","in":"header","name":"Accept-Language","schema":{"description":"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).","type":"string"}},{"description":"Retrieve details for a specific board.","in":"path","name":"board_id","required":true,"schema":{"description":"Retrieve details for a specific board.","nullable":true,"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BoardDetail"}}},"description":"Success"},"400":{"description":"InvalidParameterValue"},"401":{"description":"Unauthorized"},"404":{"description":"BoardNotFound"}},"summary":"Get assets and metadata for a specific board","tags":["Boards"]},"put":{"parameters":[{"description":"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).","in":"header","name":"Accept-Language","schema":{"description":"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).","type":"string"}},{"description":"Specify the board to update.","in":"path","name":"board_id","required":true,"schema":{"description":"Specify the board to update.","nullable":true,"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BoardInfo"}}},"description":"Specify a new name and description for the board (name is required)."},"responses":{"200":{"description":"Success"},"204":{"description":"Updated"},"400":{"description":"InvalidParameterValue"},"401":{"description":"Unauthorized"},"403":{"description":"InsufficientAccess"},"404":{"description":"BoardNotFound"}},"summary":"Update a board","tags":["Boards"]}},"/v3/boards/{board_id}/assets":{"delete":{"parameters":[{"description":"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).","in":"header","name":"Accept-Language","schema":{"description":"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).","type":"string"}},{"description":"Specify the board to remove assets from.","in":"path","name":"board_id","required":true,"schema":{"description":"Specify the board to remove assets from.","nullable":true,"type":"string"}},{"description":"List the assets to be removed from the board.","in":"query","name":"asset_ids","schema":{"description":"List the assets to be removed from the board.","items":{"type":"string"},"nullable":true,"type":"array"}}],"responses":{"200":{"description":"Success"},"400":{"description":"InvalidParameterValue"},"401":{"description":"Unauthorized"},"403":{"description":"InsufficientAccess"},"404":{"description":"BoardNotFound"}},"summary":"Remove assets from a board","tags":["Boards"]},"put":{"parameters":[{"description":"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).","in":"header","name":"Accept-Language","schema":{"description":"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).","type":"string"}},{"description":"Specify the board to add assets to.","in":"path","name":"board_id","required":true,"schema":{"description":"Specify the board to add assets to.","nullable":true,"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"description":"List assets to add to the board.","items":{"$ref":"#/components/schemas/BoardAsset"},"nullable":true,"type":"array"}}},"description":"List assets to add to the board."},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddBoardAssetsResult"}}},"description":"Created"},"400":{"description":"InvalidParameterValue"},"401":{"description":"Unauthorized"},"403":{"description":"InsufficientAccess"},"404":{"description":"BoardNotFound"}},"summary":"Add assets to a board","tags":["Boards"]}},"/v3/boards/{board_id}/assets/{asset_id}":{"delete":{"parameters":[{"description":"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).","in":"header","name":"Accept-Language","schema":{"description":"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).","type":"string"}},{"description":"Specify the board to remove an asset from.","in":"path","name":"board_id","required":true,"schema":{"description":"Specify the board to remove an asset from.","nullable":true,"type":"string"}},{"description":"Specify the asset to remove from the board.","in":"path","name":"asset_id","required":true,"schema":{"description":"Specify the asset to remove from the board.","nullable":true,"type":"string"}}],"responses":{"200":{"description":"Success"},"400":{"description":"InvalidParameterValue"},"401":{"description":"Unauthorized"},"403":{"description":"InsufficientAccess"},"404":{"description":"BoardNotFound"}},"summary":"Remove an asset from a board","tags":["Boards"]},"put":{"parameters":[{"description":"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).","in":"header","name":"Accept-Language","schema":{"description":"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).","type":"string"}},{"description":"Specify the board to add an asset to.","in":"path","name":"board_id","required":true,"schema":{"description":"Specify the board to add an asset to.","nullable":true,"type":"string"}},{"description":"Specify the asset to add to the board. If it is already in the board's asset collection, no action is taken.","in":"path","name":"asset_id","required":true,"schema":{"description":"Specify the asset to add to the board. If it is already in the board's asset collection, no action is taken.","nullable":true,"type":"string"}}],"responses":{"201":{"description":"Created"},"400":{"description":"InvalidParameterValue"},"401":{"description":"Unauthorized"},"403":{"description":"AssetNotFound"},"404":{"description":"BoardNotFound"}},"summary":"Add an asset to a board","tags":["Boards"]}},"/v3/boards/{board_id}/comments":{"get":{"parameters":[{"description":"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).","in":"header","name":"Accept-Language","schema":{"description":"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).","type":"string"}},{"description":"Specify the board to retrieve comments from.","in":"path","name":"board_id","required":true,"schema":{"description":"Specify the board to retrieve comments from.","nullable":true,"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentsList"}}},"description":"Success"},"400":{"description":"InvalidParameterValue"},"401":{"description":"Unauthorized"},"404":{"description":"BoardNotFound"}},"summary":"Get comments from a board","tags":["Boards"]},"post":{"parameters":[{"description":"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).","in":"header","name":"Accept-Language","schema":{"description":"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).","type":"string"}},{"description":"Specify the board to add a comment to.","in":"path","name":"board_id","required":true,"schema":{"description":"Specify the board to add a comment to.","nullable":true,"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentRequest"}}},"description":"Comment to be added to the board."},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentCreated"}}},"description":"Created"},"400":{"description":"InvalidParameterValue"},"401":{"description":"Unauthorized"},"403":{"description":"InsufficientAccess"},"404":{"description":"BoardNotFound"}},"summary":"Add a comment to a board","tags":["Boards"]}},"/v3/boards/{board_id}/comments/{comment_id}":{"delete":{"parameters":[{"description":"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).","in":"header","name":"Accept-Language","schema":{"description":"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).","type":"string"}},{"description":"Specify the board containing the comment to delete.","in":"path","name":"board_id","required":true,"schema":{"description":"Specify the board containing the comment to delete.","nullable":true,"type":"string"}},{"description":"Specify the comment to delete.","in":"path","name":"comment_id","required":true,"schema":{"description":"Specify the comment to delete.","nullable":true,"type":"string"}}],"responses":{"200":{"description":"Success"},"204":{"description":"CommentDeleted"},"400":{"description":"InvalidParameterValue"},"401":{"description":"Unauthorized"},"403":{"description":"InsufficientAccess"},"404":{"description":"BoardNotFound"}},"summary":"Delete a comment from a board","tags":["Boards"]}},"/v3/collections":{"get":{"description":"Use this endpoint to retrieve collections associated with your Getty Images account. To browse available collections see our [Image collections page]( http://www.gettyimages.com/creative-images/collections).\n\nYou'll need an API key and access token to use this resource.\n","parameters":[{"description":"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).","in":"header","name":"Accept-Language","schema":{"description":"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).","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionsList"}}},"description":"OK"},"401":{"description":"Unauthorized"}},"summary":"Gets collections applicable for the customer.","tags":["Collections"]}},"/v3/countries":{"get":{"description":"Returns a list of country objects that contains country name, two letter ISO abbreviation and three letter ISO abbreviation.\n\nYou'll need an API key and access token to use this resource.\n","parameters":[{"description":"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).","in":"header","name":"Accept-Language","schema":{"description":"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).","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CountriesList"}}},"description":"OK"},"401":{"description":"Unauthorized"}},"summary":"Gets countries codes and names.","tags":["Countries"]}},"/v3/customers/current":{"get":{"description":"Returns the first, middle and last name of the authenticated user.\n\nYou'll need an API key and access token to use this resource.\n\t\nPlease consult our [Authorization FAQ](http://developers.gettyimages.com/en/authorization-faq.html) for more information on authorization tokens.\n","parameters":[{"description":"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).","in":"header","name":"Accept-Language","schema":{"description":"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).","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerInfoResponse"}}},"description":"OK"},"400":{"description":"InvalidRequestParameters"},"401":{"description":"Unauthorized"},"503":{"description":"ServiceUnavailable"}},"summary":"Returns information about the current user.","tags":["Customers"]}},"/v3/downloads":{"get":{"description":"Returns information about a customer's previously downloaded assets.\n\nYou'll need an API key and access token to use this resource.\n \n\t\nThis endpoint requires being a Getty Images customer to limit your results to only assets that you have a license to use, \nyou need to also include an authorization token in the header of your request. \nPlease consult our [Authorization FAQ](http://developers.gettyimages.com/en/authorization-faq.html) for more information on authorization tokens.\n","parameters":[{"description":"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).","in":"header","name":"Accept-Language","schema":{"description":"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).","type":"string"}},{"description":"If specified, selects assets downloaded on or after this date. Dates should be submitted in ISO 8601 format (i.e., YYYY-MM-DD). \r\nAny hour, minute, second values in the request are not used, unless useTimePart parameter is included.\r\nDate/times in the response are UTC. Default is 30 days prior to date_to","in":"query","name":"date_from","schema":{"description":"If specified, selects assets downloaded on or after this date. Dates should be submitted in ISO 8601 format (i.e., YYYY-MM-DD). \r\nAny hour, minute, second values in the request are not used, unless useTimePart parameter is included.\r\nDate/times in the response are UTC. Default is 30 days prior to date_to","format":"date-time","nullable":true,"type":"string"}},{"description":"If specified, selects assets downloaded on or before this date. Dates should be submitted in ISO 8601 format (i.e., YYYY-MM-DD)\r\nAny hour, minute, second values in the request are not used, unless useTimePart parameter is included.\r\nDate/times in the response are UTC. Default is current date or 30 days after specified start date, whichever one is earlier.","in":"query","name":"date_to","schema":{"description":"If specified, selects assets downloaded on or before this date. Dates should be submitted in ISO 8601 format (i.e., YYYY-MM-DD)\r\nAny hour, minute, second values in the request are not used, unless useTimePart parameter is included.\r\nDate/times in the response are UTC. Default is current date or 30 days after specified start date, whichever one is earlier.","format":"date-time","nullable":true,"type":"string"}},{"description":"If specified, time values provided with date_to or date_from will be used. Time values should be appended to the date value in ISO 8601 format\r\ni.e.: 2019-09-19T19:30:37 or 2019-09-19 19:30:37.  Time zone can be specified as optional.\r\nDefault value is false","in":"query","name":"use_time","schema":{"default":false,"description":"If specified, time values provided with date_to or date_from will be used. Time values should be appended to the date value in ISO 8601 format\r\ni.e.: 2019-09-19T19:30:37 or 2019-09-19 19:30:37.  Time zone can be specified as optional.\r\nDefault value is false","type":"boolean"}},{"description":"Identifies page to return. Default is 1.","in":"query","name":"page","schema":{"default":1,"description":"Identifies page to return. Default is 1.","format":"int32","type":"integer"}},{"description":"Specifies page size. Default is 30, maximum page_size is 100.","in":"query","name":"page_size","schema":{"default":30,"description":"Specifies page size. Default is 30, maximum page_size is 100.","format":"int32","type":"integer"}},{"description":"Specifies product type to be included in the previous download results. Product types easyaccess, editorialsubscription, imagepack, and premiumaccess are for GettyImages API keys. Product types royaltyfreesubscription and creditpack are for iStock API keys. To get previous iStockPhoto credit downloads, creditpack must be selected.","in":"query","name":"product_type","schema":{"$ref":"#/components/schemas/ProductTypeForDownloads"}},{"description":"If specified, returns the list of previously downloaded images for all users in your company. Your account must be enabled for this functionality. Contact your Getty Images account rep for more information. Default is false.","in":"query","name":"company_downloads","schema":{"default":false,"description":"If specified, returns the list of previously downloaded images for all users in your company. Your account must be enabled for this functionality. Contact your Getty Images account rep for more information. Default is false.","type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetDownloadsResponse"}}},"description":"OK"},"400":{"description":"Bad request"},"401":{"description":"AuthorizationTokenRequired"},"403":{"description":"Forbidden"}},"summary":"Returns information about a customer's downloaded assets.","tags":["Downloads"]}},"/v3/downloads/images/{id}":{"post":{"description":"Use this endpoint to generate download URLs and related data for images you are authorized to download.\n\nMost product offerings have enforced periodic download limits such as monthly, weekly, and daily. When this operation executes, the count of allowed downloads is decremented by one for the product offering. Once the download limit is reached for a given product offering, no further downloads may be requested for that product offering until the next download period.\n\nThe download limit for a given download period is covered in your product agreement established with Getty Images.\n\nYou'll need an API key and a [Resource Owner Grant or Implicit Grant](http://developers.gettyimages.com/en/authorization-faq.html) access token to use this resource.\n\n## Auto Downloads\nThe `auto_download` request query parameter specifies whether to automatically download the image.\n\nIf the `auto_download` request query parameter is set to _true_, the API will return an HTTP status code 303 *See Other*. Your client code will need to process this response and redirect to the URI specified in the *Location* header to enable you to automatically download the file. The redirection workflow follows the [HTTP 1.1 protocol](https://tools.ietf.org/html/rfc7231#section-6.4.4).\n\nClient Request:\n\n```\nhttps://api.gettyimages.com/v3/downloads/images/[asset_id]?auto_download=true\n```\n\nServer Response:\n\nYour client code should follow redirect (3xx) status codes returned from the URI in the response Location header. More information here: [HTTP 1.1 protocol](https://tools.ietf.org/html/rfc7231#section-6.4).\n\n```\nHTTP/1.1 303 See Other\nLocation: https://delivery.gettyimages.com/...\n```\n\nIf the `auto_download` request query parameter is set to false, the API will return a HTTP status code 200, along with the URI in the response body which can be used to download the image. \n\nClient Request:\n\n```\nhttps://api.gettyimages.com/v3/downloads/images/[asset_id]?auto_download=false\n```\n\nServer Response:\n\n```\nHTTP/1.1 200 OK\n{\n\t\"uri\": \"https://delivery.gettyimages.com/...\"\n}\n```\n## Downloading Via the Returned URI\n\nYour client code should follow redirect (3xx) status codes returned from the URI in the response. More information here: [HTTP 1.1 protocol](https://tools.ietf.org/html/rfc7231#section-6.4).\n\nThe URI returned by this call should be considered opaque and the format could change at any time.\nIn order to get the filename, length or file type, the response headers must be inspected. An example\nresponse follows:\n\n```\ncontent-length: 33959979\ncontent-type: image/jpeg\ncontent-disposition: attachment; filename=GettyImages-1167612765.jpg\n```\n\nThe `content-disposition` header must be parsed to get a usable filename.\n\n## Download URI expiration\n\nDownload URIs are _**only valid for 24 hours**_, starting from the moment they are returned from this call.\n","parameters":[{"description":"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).","in":"header","name":"Accept-Language","schema":{"description":"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).","type":"string"}},{"description":"<remarks>\r\n                    Id of image to download.\r\n                </remarks>","in":"path","name":"id","required":true,"schema":{"description":"<remarks>\r\n                    Id of image to download.\r\n                </remarks>","nullable":true,"type":"string"}},{"description":"<remarks>\r\n                    Specifies whether to auto-download the image. If true is specified, a 303 SeeOther status is returned with a\r\n                    Location header set to the location of the image.\r\n                    If false is specified, the download URI will be returned in the response message. Default is true.\r\n                </remarks>","in":"query","name":"auto_download","schema":{"default":true,"description":"<remarks>\r\n                    Specifies whether to auto-download the image. If true is specified, a 303 SeeOther status is returned with a\r\n                    Location header set to the location of the image.\r\n                    If false is specified, the download URI will be returned in the response message. Default is true.\r\n                </remarks>","type":"boolean"}},{"description":"<remarks>\r\n                    File Type expressed with three character file extension.\r\n