--- title: "Get metadata for a single image by supplying one image id" method: GET path: "/v3/images/{id}" tags: ["Images"] --- # Get metadata for a single image by supplying one image id `GET /v3/images/{id}` This endpoint returns the detailed image metadata for a specified image. You'll need an API key and access token to use this resource. ## Working with Fields Sets Fields sets are used in the **fields** request parameter to receive a suite of metadata fields. The following fields sets are available: #### Summary Fields Set The **summary_set** query string parameter fields value represents a small batch of metadata fields that are often used to build search response results. The following fields are provided for every image in your result set when you include **summary_set** in your request. ``` { "images": [ "artist", "asset_family", "caption", "collection_code", "collection_id", "collection_name", "license_model", "max_dimensions", "title" ] } ``` #### Detail Fields Set The **detail_set** query string parameter fields value represents a large batch of metadata fields that are often used to build a detailed view of images. The following fields are provided for every image in your result set when you include **detail_set** in your request. ``` { "images": [ "allowed_use", "artist", "artist_title", "asset_family", "call_for_image", "caption", "city", "collection_code", "collection_id", "collection_name", "color_type", "copyright", "country", "credit_line", "date_created", "date_submitted", "download_sizes", "editorial_segments", "event_ids", "graphical_style", "license_model", "max_dimensions", "orientation", "product_types", "quality_rank", "referral_destinations", "state_province", "title" ] } ``` #### Display Fields Set The **display_set** query string parameter fields value represents the fields that provide you with URLs for the low resolution files that are most frequently used to build a UI displaying search results. The following fields are provided for every image in your result set when you include **display_set** in your request. The URI provided is subject to change at any time and must be used as-is with no modification. ``` { "images": [ "display_sizes": [ { "is_watermarked": , "name": "comp", "uri": "" }, { "is_watermarked": , "name": "preview", "uri": "" }, { "is_watermarked": , "name": "thumb", "uri": "" } ] ] } ``` ## Path parameters - `id` string, required ## Query parameters - `fields` GettyImagesServicesConnectPublicControllersImagesImageDetailFieldValues[] ## 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). ## Response `200` OK - GettyImagesServicesConnectPublicModelsImagesImagesDetail - `images` GettyImagesServicesConnectPublicModelsImagesImageDetail[], nullable - `allowed_use` GettyImagesServicesConnectPublicModelsAllowedUse - `how_can_i_use_it` string, nullable — Indicates how the asset can be used - `release_info` string, nullable — Indicates release status - `usage_restrictions` string[], nullable — Indicates asset usage restriction, if any - `editorial_use_only` boolean — Indicates whether the asset is for editorial use only - `alternative_ids` object, nullable - `artist` string, nullable - `artist_title` string, nullable - `asset_family` string, nullable - `call_for_image` boolean, nullable - `caption` string, nullable - `city` string, nullable - `collection_code` string, nullable - `collection_id` integer, nullable - `collection_name` string, nullable - `color_type` string, nullable - `copyright` string, nullable - `country` string, nullable - `credit_line` string, nullable - `date_camera_shot` string, date-time, nullable - `date_created` string, date-time, nullable - `date_submitted` string, date-time, nullable - `display_sizes` GettyImagesServicesConnectPublicModelsImagesImageDetailDisplaySize[], nullable - `height` integer, nullable — Indicates the height in pixels - `is_watermarked` boolean — Indicates whether the image is watermarked. - `name` string, nullable — Identifies the name of the display size - `uri` string, nullable — Identifies the URI for the image - `width` integer, nullable — Indicates the width in pixels - `download_product` string, nullable - `download_sizes` GettyImagesServicesConnectPublicModelsImagesImageDownloadSize[], nullable - `bytes` integer - `downloads` GettyImagesServicesConnectPublicModelsImagesImageDownloadAuthorization[], nullable - `product_id` string, nullable - `product_type` string, nullable - `uri` string, nullable - `agreement_name` string, nullable - `height` integer - `media_type` string, nullable - `name` 'x_small' | 'small' | 'medium' | 'large' | 'x_large' | 'xx_large' | 'vector' - `width` integer - `dpi` integer - `editorial_segments` string[], nullable - `editorial_source` GettyImagesServicesConnectPublicModelsImagesEditorialSource - `id` integer - `name` string, nullable - `event_ids` integer[], nullable - `graphical_style` string, nullable - `id` string, nullable - `is_ai_editable` boolean, nullable - `keywords` GettyImagesServicesConnectPublicModelsKeyword[], nullable - `keyword_id` string, nullable - `text` string, nullable - `type` string, nullable - `relevance` integer, nullable - `largest_downloads` GettyImagesServicesConnectPublicModelsImagesImageDownloadSize[], nullable - `bytes` integer - `downloads` GettyImagesServicesConnectPublicModelsImagesImageDownloadAuthorization[], nullable - `product_id` string, nullable - `product_type` string, nullable - `uri` string, nullable - `agreement_name` string, nullable - `height` integer - `media_type` string, nullable - `name` 'x_small' | 'small' | 'medium' | 'large' | 'x_large' | 'xx_large' | 'vector' - `width` integer - `dpi` integer - `license_model` string, nullable - `links` GettyImagesServicesConnectPublicModelsImagesLink[], nullable - `rel` string, nullable - `uri` string, nullable - `max_dimensions` GettyImagesServicesConnectPublicModelsMaxDimensions - `height` integer - `width` integer - `orientation` string, nullable - `people` string[], nullable - `product_types` string[], nullable - `quality_rank` integer, nullable - `referral_destinations` GettyImagesServicesConnectPublicModelsReferralDestination[], nullable - `site_name` string, nullable - `uri` string, nullable - `state_province` string, nullable - `title` string, nullable - `uri_oembed` string, nullable - `istock_licenses` GettyImagesServicesConnectPublicModelsIStockLicense[], nullable - `license_type` 'Standard' | 'Multiseat' | 'Unlimited' | 'Resale' | 'Indemnification' - `credits` integer - `istock_collection` string, nullable - `istock_exclusive` boolean, nullable - `contributor` GettyImagesServicesConnectPublicModelsContributor — Contributor information for an image or video - `member_name` string, nullable — The contributor's member name - `display_name` string, nullable — The contributor's display name - `object_name` string, nullable - `images_not_found` string[], nullable ## Other responses - `400` — InvalidParameterValue - `401` — AuthorizationTokenRequired - `403` — UnauthorizedDisplaySize - `404` — ImageNotFound - `500` — InvalidIStockCollection --- [API](https://skmtc.net/gettyimages/apis/getty-images-api.md) · [All operations](https://skmtc.net/gettyimages/apis/getty-images-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gettyimages/getty-images-api/revisions/d069958d92a6/schema)