---
title: "List collections"
method: GET
path: "/v0/collections"
tags: ["Browse & search"]
---

# List collections

`GET /v0/collections`

The collections endpoint returns playlists curated by our team of in-house experts.

We offer collections for any occasion: from holidays like "Día de Muertos" to content types like "Real Estate" or "Badass ads".

You can manage the order and which collections are part or your applications' free tier via the developer portal. As default, we return the collections included in your free tier first, followed by all collections in the Epidemic Sound library.

Collections have attributes like title and cover art. In the few cases where we do not have cover art for a collection we return a default image.

You can choose to return collections with or without tracks. The response will include a maximum of 20 tracks per collection. If a collection contains more than 20 tracks use endpoint '/collections/{collectionId}' to get all tracks.

## Query parameters

- `excludeField` 'tracks'
- `limit` integer
- `offset` integer

## Response `200`

Collection response

- CollectionsPaginatedResponse
  - `collections` CollectionResponse[], required
    - `id` string, uuid, required — Unique ID of the track.
    - `name` string, required — Name of the collection
    - `tracks` TrackResponse[], required
      - `id` string, required — Unique ID of the track
      - `mainArtists` string[], required — The main artist that created the track.
      - `featuredArtists` string[], required — Additional artists that contributed to the track.
      - `title` string, required — Title of the track
      - `bpm` integer, required — Beats per minute for the track.
      - `length` integer, required — Track length in seconds
      - `moods` MoodResponse[], required — Lists the moods of the track.
        - `id` string, required — Unique ID of the mood
        - `name` string, required — Name of the mood
      - `genres` GenreResponse[], required — Lists the genres of the track.
        - `id` string, required
        - `name` string, required
        - `parent` ParentGenreResponse
          - `id` string, required — Unique ID of the parent genre
          - `name` string, required — Name of the parent genre
      - `images` ImagesResponse
        - `default` string, nullable
        - `M` string, nullable
        - `L` string, nullable
        - `S` string, nullable
        - `XS` string, nullable
      - `waveformUrl` string, required — Reference to the waveform as a json object.
      - `hasVocals` boolean, nullable — Set to true if the track has vocals. Set to false for instrumental tracks.
      - `added` string, required — The date the track was released in the format YYYY-mm-dd.
      - `tierOption` 'PAID' | 'FREE', nullable
      - `isrc` string, nullable — International Standard Recording Code (ISRC) of the track, e.g. "SE5Q52401263".
      - `vocalType` 'LEAD' | 'PRESENCE' | 'NONE', nullable — Granular vocal classification: LEAD (sung lead vocals), PRESENCE (vocal chops/samples/ad-libs/textures) or NONE (instrumental). Null when unknown.
      - `isExplicit` boolean, nullable
      - `isPreviewOnly` boolean
    - `availableTracks` integer, nullable — Number of available tracks based on the partner's tier
    - `images` CollectionImagesPublicResponse, required
      - `default` string, required
      - `M` string, nullable
      - `L` string, nullable
      - `S` string, nullable
      - `XS` string, nullable
  - `pagination` Pagination, required
    - `page` integer, required
    - `limit` integer, required
    - `offset` integer
  - `links` PaginationLinks, required
    - `next` string, nullable
    - `prev` string, nullable

## Other responses

- `401` — Unauthorized. Most likely your access token has expired.
- `429` — Rate limit exceeded.

---

[API](https://skmtc.net/epidemicsound/apis/partner-content-api.md) · [All operations](https://skmtc.net/epidemicsound/apis/partner-content-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/epidemicsound/partner-content-api/revisions/c2fa1c98dbc2/schema)