---
title: "List your collections"
method: GET
path: "/api/v1/assets/collections"
tags: ["Asset Management"]
---

# List your collections

`GET /api/v1/assets/collections`

## Request

- Base URL: `https://api.imagestep.dev`
- URL: `https://api.imagestep.dev/api/v1/assets/collections`
- Auth: API key in header `Authorization`

Every collection your assets are in, one row each: the name, how many assets are in it and when
the latest one was created — most recently added to first. `count` is the total
GET /api/v1/assets?collection= reports for that name. `q` narrows the list to names containing
it, case-insensitively. A chain job's intermediates are not counted and their `job:` collections
are not listed.

USE THIS WHEN:
- Finding out which collections exist before filtering or submitting into one
- Checking a collection name's spelling (a misspelt name is simply a new collection)

DO NOT USE WHEN:
- Listing the assets in a collection → use GET /api/v1/assets?collection=

## Query parameters

- `q` string
- `page` integer
- `perPage` integer
- `cursor` string

## Response `200`

One page of collections; `meta` carries `hasMore` and `nextCursor`

## Other responses

- `400`: `invalid_param` on `cursor` — malformed, taken from another listing, or sent together with `page`
- `429`: Rate limited — `error.code` is `rate_limited` and `retryable` is true. `Retry-After` says how many seconds to wait.

---

[API](https://skmtc.dev/imagestep/apis/imagestep-api.md) · [All operations](https://skmtc.dev/imagestep/apis/imagestep-api/llms.txt) · [OpenAPI document](https://skmtc.dev/imagestep/apis/imagestep-api/revisions/5e8e922a3085?raw)