---
title: "Retrieve collections"
url: "https://earlyaccess.developers.bynder.com/apis/collections-api-1/versions/fa75179f-d3db-46c2-8693-3128e9d35db4/paths/api-v4-collections/get"
---

> Full API specification: https://earlyaccess.developers.bynder.com/apis/collections-api-1/versions/fa75179f-d3db-46c2-8693-3128e9d35db4.md

# Retrieve collections

`GET` `/api/v4/collections`

Retrieve a list of collections.

## Query parameters

- `limit` (integer, optional)
- `page` (integer, optional)
- `orderBy` (string, optional)
- `ids` (string, optional)
- `count` (boolean, optional)
- `keyword` (string, optional)
- `isPublic` (boolean, optional)
- `minCount` (integer, optional)

## Responses

- `200` - A list of collections.
- `400` - Invalid request parameters.

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Collections API
  version: 1.0.0
servers:
  - url: https://{your-bynder-domain}/
paths:
  /api/v4/collections:
    get:
      description: Retrieve a list of collections.
      parameters:
        - in: query
          name: limit
          schema:
            default: 50
            maximum: 1000
            type: integer
        - in: query
          name: page
          schema:
            default: 1
            type: integer
        - in: query
          name: orderBy
          schema:
            enum:
              - dateCreated asc
              - dateCreated desc
              - name asc
              - name desc
            type: string
        - in: query
          name: ids
          schema:
            example: 00000000-0000-0000-0000000000000000,00000000-0000-0000-0000000000000000
            type: string
        - in: query
          name: count
          schema:
            default: false
            type: boolean
        - in: query
          name: keyword
          schema:
            example: Amsterdam
            type: string
        - in: query
          name: isPublic
          schema:
            default: false
            type: boolean
        - in: query
          name: minCount
          schema:
            default: 0
            type: integer
      responses:
        "200":
          content:
            application/json:
              examples:
                example1:
                  value:
                    - collectionCount: 2
                      cover:
                        large: ___URL_TO_BYNDER_CDN___
                        thumbnail: ___URL_TO_BYNDER_CDN___
                        thumbnails:
                          - ___URL_TO_BYNDER_CDN___
                          - ___URL_TO_BYNDER_CDN___
                          - ___URL_TO_BYNDER_CDN___
                      dateCreated: March, 01 2017 10:49:12 +0000
                      dateModified: March, 08 2017 14:17:37 +0000
                      description: Collection 1 with various assets.
                      filename: collection_1
                      id: 00B627BB-8054-44C0-A343FCF40BC790CD
                      isPublic: true
                      name: Collection 1
                      user:
                        id: 48817BA7-2FC3-4A43-918761514D322C15
                        name: John Doe
                      userId: 48817BA7-2FC3-4A43-918761514D322C15
                    - collectionCount: 4
                      cover:
                        large: ___URL_TO_BYNDER_CDN___
                        thumbnail: ___URL_TO_BYNDER_CDN___
                        thumbnails:
                          - ___URL_TO_BYNDER_CDN___
                          - ___URL_TO_BYNDER_CDN___
                          - ___URL_TO_BYNDER_CDN___
                      dateCreated: October, 30 2014 13:54:00 +0000
                      dateModified: March, 10 2017 07:57:18 +0000
                      description: Collection 2 with various assets.
                      filename: collection_2
                      id: 050960F7-98B3-461D-B967F4B84D3A3866
                      isPublic: false
                      name: Collection 2
                      user:
                        id: 80E53210-5BB0-4BF9-907F917D457801BB
                        name: Jane Doe
                      userId: 80E53210-5BB0-4BF9-907F917D457801BB
              schema:
                items:
                  properties:
                    collectionCount:
                      example: 2
                      type: integer
                    cover:
                      properties:
                        large:
                          example: ___URL_TO_BYNDER_CDN___
                          type: string
                        thumbnail:
                          example: ___URL_TO_BYNDER_CDN___
                          type: string
                        thumbnails:
                          items:
                            example: ___URL_TO_BYNDER_CDN___
                            type: string
                          type: array
                      type: object
                    dateCreated:
                      example: March, 01 2017 10:49:12 +0000
                      type: string
                    dateModified:
                      example: March, 08 2017 14:17:37 +0000
                      type: string
                    description:
                      example: Collection 1 with various assets.
                      type: string
                    filename:
                      example: collection_1
                      type: string
                    id:
                      example: 00B627BB-8054-44C0-A343FCF40BC790CD
                      type: string
                    isPublic:
                      example: true
                      type: boolean
                    name:
                      example: Collection 1
                      type: string
                    user:
                      properties:
                        id:
                          example: 48817BA7-2FC3-4A43-918761514D322C15
                          type: string
                        name:
                          example: John Doe
                          type: string
                      type: object
                    userId:
                      example: 48817BA7-2FC3-4A43-918761514D322C15
                      type: string
                  type: object
                type: array
          description: A list of collections.
        "400":
          content:
            application/json:
              schema:
                properties:
                  message:
                    example: Invalid request parameters.
                    type: string
                  statuscode:
                    example: 400
                    type: integer
                type: object
          description: Invalid request parameters.
      security:
        - OAuth2:
            - collection.public.view
            - INBOXPUBLIC
            - OUTBOXPUBLIC
            - PUBLICCOLLECTIONS
        - permanentToken:
            - collection.public.view
            - INBOXPUBLIC
            - OUTBOXPUBLIC
            - PUBLICCOLLECTIONS
      summary: Retrieve collections
      tags:
        - Collections
security:
  - OAuth2:
      - collection.public.view
      - INBOXPUBLIC
      - OUTBOXPUBLIC
      - PUBLICCOLLECTIONS
  - permanentToken:
      - collection.public.view
      - INBOXPUBLIC
      - OUTBOXPUBLIC
      - PUBLICCOLLECTIONS
components:
  securitySchemes:
    OAuth2:
      flows:
        authorizationCode:
          authorizationUrl: https://{your-auth-url}
          scopes:
            COLLECTIONS: ""
            INBOXPUBLIC: To retrieve collections other users shared/received
            OUTBOXPUBLIC: To retrieve collections other users shared/received
            PUBLICCOLLECTIONS: To retrieve collections other users created
            PUBLISHCOLLECTIONS: ""
            SHARECOLLECTION: ""
            SHARING: ""
            collection.public.view: To retrieve public collections
          tokenUrl: https://{your-bynder-domain}/v6/authentication/oauth2/token
        clientCredentials:
          scopes:
            COLLECTIONS: ""
            INBOXPUBLIC: To retrieve collections other users shared/received
            OUTBOXPUBLIC: To retrieve collections other users shared/received
            PUBLICCOLLECTIONS: To retrieve collections other users created
            PUBLISHCOLLECTIONS: ""
            SHARECOLLECTION: ""
            SHARING: ""
            collection.public.view: To retrieve public collections
          tokenUrl: https://{your-bynder-domain}/v6/authentication/oauth2/token
      type: oauth2
    permanentToken:
      in: header
      name: Authorization
      type: apiKey
```