---
title: "Retrieve collections"
method: GET
path: "/api/v4/collections"
tags: ["Collections"]
---

# Retrieve collections

`GET /api/v4/collections`

## Request

- Base URL: `https://{your-bynder-domain}`
- URL: `https://{your-bynder-domain}/api/v4/collections`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://{your-auth-url}`
    - Client credentials
    - Token URL: `https://{your-bynder-domain}/v6/authentication/oauth2/token` scopes: `collection.public.view`, `INBOXPUBLIC`, `OUTBOXPUBLIC`, `PUBLICCOLLECTIONS`
  - API key in header `Authorization`

Retrieve a list of collections.

## Query parameters

- `limit` integer
- `page` integer
- `orderBy` 'dateCreated asc' | 'dateCreated desc' | 'name asc' | 'name desc'
- `ids` string
- `count` boolean
- `keyword` string
- `isPublic` boolean
- `minCount` integer

## Response `200`

A list of collections.

- object[]
  - `userId` string
  - `dateModified` string
  - `filename` string
  - `dateCreated` string
  - `collectionCount` integer
  - `id` string
  - `name` string
  - `cover` object
    - `thumbnail` string
    - `thumbnails` string[]
    - `large` string
  - `user` object
    - `id` string
    - `name` string
  - `description` string
  - `isPublic` boolean

## Other responses

- `400`: Invalid request parameters.

---

[API](https://skmtc.dev/bynder/apis/collections-api.md) - [All operations](https://skmtc.dev/bynder/apis/collections-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bynder/apis/collections-api/revisions/fee88bfdb015?raw)