> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

# ListGalleryItems

# Package: proGallery

# Namespace: ProGallery

# Method link: https://dev.wix.com/docs/api-reference/assets/pro-gallery/list-gallery-items.md

## Permission Scopes:
Read Galleries: SCOPE.DC-PROGALLERY.READ-GALLERIES

## Introduction

Retrieves a list of media items in a specified gallery.

---

## REST API

### Schema

```
 Method: listGalleryItems
 Description: Retrieves a list of media items in a specified gallery.
 URL: https://www.wixapis.com/pro-gallery/v2/galleries/{galleryId}/items
 Method: GET
 # Note: If the parameter `a.b` is listed under required parameters, `b` is only required if `a` is also present.
 Required parameters:  galleryId
 Method parameters: 
   param name: galleryId | type:   none | required: true
   query param name: itemLimit | type: itemLimit | description: Maximum number of media items to return. <br />  Min: `1` <br /> Max: `100` <br /> Default: `50` 
   query param name: itemOffset | type: itemOffset | description: Number of media items to skip in the response. <br />  Default: `0` 
 Return type: ListGalleryItemsResponse
  - name: items | type: array<Item> | description: List of media items in the gallery. 
     - ONE-OF: 
        - name: image | type: Image | description: Details about the image. 
           - name: imageInfo | type: Image | description: Information about the Wix Media image. 
              - name: id | type: string | description: *Required.** WixMedia image GUID. 
              - name: url | type: string | description: Image URL. 
              - name: height | type: integer | description: *Required.** Original image height. 
              - name: width | type: integer | description: *Required.** Original image width. 
              - name: altText | type: string | description: Image alt text. 
              - name: filename | type: string | description: Image filename. 
           - name: focalPoint | type: Point | description: Focal point of the image. 
              - name: x | type: number | description: X-coordinate of the focal point. 
              - name: y | type: number | description: Y-coordinate of the focal point. 
           - name: exif | type: object | description: Set of key-value pairs describing the media in [Exchangeable Image File format](https://en.wikipedia.org/wiki/Exif). 
           - name: quality | type: integer | description: Image compression level. <br />  Min: `30` <br /> Max: `100` 
           - name: unsharpMasking | type: UnsharpMasking | description: [Unsharp masking](https://en.wikipedia.org/wiki/Unsharp_masking) values of the image. 
              - name: amount | type:  | description: Unsharp masking amount. Controls the sharpening strength. <br />  Min: `0` <br /> Max: `5` 
              - name: radius | type:  | description: Unsharp masking radius in pixels. Controls the sharpening width. 
              - name: threshold | type:  | description: Unsharp masking threshold. Controls how different neighboring pixels must be for sharpening to apply. <br />  Min: `0` <br /> Max: `1` 
        - name: video | type: Video | description: Details about the video. 
           - name: type | type: VideoType | description: Type of video. 
                 - enum: UNDEFINED, WIX_MEDIA, YOUTUBE, VIMEO
           - name: videoInfo | type: VideoV2 | description: Information about the video. 
              - name: id | type: string | description: WixMedia GUID. Required when associating an existing Wix Media video. 
              - name: url | type: string | description: Video URL. Required when associating a video from an external source. Supported sources: YouTube, Vimeo. 
              - name: resolutions | type: array<VideoResolution> | description: Available resolutions for the video, starting with the optimal resolution. 
                 - name: url | type: string | description: *Required.** Video URL. 
                 - name: height | type: integer | description: *Required.** Video height. 
                 - name: width | type: integer | description: *Required.** Video width. 
                 - name: format | type: string | description: *Required.** Video format. For example, `mp4` or `hls`. 
                 - name: quality | type: string | description: Video quality. For example, `480p` or `720p`. 
                 - name: filename | type: string | description: Video filename. 
              - name: filename | type: string | description: Video filename. 
              - name: posters | type: array<Image> | description: Video posters. 
           - name: durationInMillis | type: integer | description: Manually defined video duration in milliseconds. 
        - name: text | type: Text | description: Details about the text file. 
           - name: html | type: string | description: Text in HTML format. 
           - name: css | type: object | description: Set of key-value pairs describing the [CSS style](https://en.wikipedia.org/wiki/CSS) of the text.  __Note:__ The object structure is customizable. See the [List Gallery Items](https://dev.wix.com/api/rest/site-content/pro-gallery/list-gallery-items) code example for supported values. 
           - name: editorHtml | type: string | description: Reserved for internal use. 
           - name: editorFontId | type: string | description: Reserved for internal use. 
     - name: id | type: string | description: Item GUID. 
     - name: sortOrder | type: number | description: Index that determines which position a media item is displayed in the gallery. <br />  Default: [Epoch](https://www.epoch101.com/) timestamp. <br />  >**Note:** If you assign the same sort order index to more than one media item in a gallery, the function fails. 
     - name: title | type: string | description: Item title. 
     - name: description | type: string | description: Item description. 
     - name: link | type: Link | description: Link from the item. You can link to Wix sites or external URLs. 
        - name: text | type: string | description: Display text of the link. 
        - name: url | type: string | description: Target URL of the link. 
     - name: type | type: Type | description: Type of item. 
         - enum: UNDEFINED, IMAGE, VIDEO, TEXT
     - name: createdDate | type: string | description: Date and time the item was created. 
     - name: updatedDate | type: string | description: Date and time the item was last updated. 
     - name: tags | type: Tags | description: Item tags. 
        - name: values | type: array | description: List of tags assigned to the media item. 


```

### Examples

### List the items in a gallery
```curl
curl -X GET \
'https://www.wixapis.com/progallery/v2/galleries/e481d9b4-14b9-4a98-ae52-67f4170e3a63/items' \
-H 'Authorization: <AUTH>'
```

---