---
title: "List image collections"
method: GET
path: "/v2/images/collections"
tags: ["images"]
---

# List image collections

`GET /v2/images/collections`

This endpoint lists your collections of images and their basic attributes.

## Query parameters

- `embed` string[]
- `page` integer
- `per_page` integer

## Response `200`

OK

- object — List of collections
  - `data` object[] — Collections
    - `cover_item` object — Metadata about an item that is part of a collection
      - `added_time` string, date-time — The date the item was added to the collection
      - `id` string, required — ID of the item
      - `media_type` string — The media type of the item, such as image, video, or audio
    - `created_time` string, date-time — When the collection was created
    - `id` string, required — The collection ID
    - `items_updated_time` string, date-time — The last time this collection's items were updated
    - `name` string, required — The name of the collection
    - `share_code` string — A code that can be used to share the collection (optional)
    - `share_url` string — The browser URL that can be used to share the collection (optional)
    - `total_item_count` integer, required — The number of items in the collection
    - `updated_time` string, date-time — The last time the collection was update (other than changes to the items in it)
  - `errors` object[] — Error list; appears only if there was an error
    - `code` string — The error code of this error
    - `data` string — Debugging information about the error
    - `items` object[] — A list of items that produced the error
    - `message` string, required — Specific details about this error
    - `path` string — Internal code reference to the source of the error
  - `message` string — Server-generated message, if any
  - `page` integer — The current page of results
  - `per_page` integer — The number of results per page
  - `total_count` integer — The total number of results across all pages

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/shutterstock/apis/shutterstock-api-explorer.md) · [All operations](https://skmtc.net/shutterstock/apis/shutterstock-api-explorer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shutterstock/shutterstock-api-explorer/versions/d2e03e7f655d/schema)