api

Get collections

GET https://api.mave.io/v1/collections

Returns the collections directly inside one folder, ordered by creation date (newest first). Without collection, only collections in the root of the space are returned. The list is not recursive and is paginated, with 15 items per page by default. Requires the API token.

The video_count for each collection does include videos in nested collections, so it can be higher than the number of videos directly inside that collection.

Query params

Param	Type
page	positive integer (default: 1)
per_page	positive integer (default: 15, max. 100)
collection	collection ID; returns only its direct child collections. Omit it or pass an empty value for the space root.
archived	boolean; `true` returns archived collections. Omitted or `false` returns active collections.

Response

{
  "current_page": 1, // the page you are looking at
  "data": [
    {
      "created": 1683272297,
      "id": "zlb1cnE31EQetyx",
      "name": "test", // name of the collection
      "object": "collection", // type of the object
      "video_count": 3 // the amount of videos in this collection
    },
    {
      "created": 1683190633,
      "id": "zlb1cAvWg15i9NW",
      "name": "Collection",
      "object": "collection",
      "video_count": 0
    }
  ], // all the collections that have been created
  "has_more": false, // the possibility whether there are more video embeds to retrieve
  "object": "list", // the type of object you're looking at
  "total_items": 2, // the total of video embeds
  "total_pages": 1 // the total pages that are available
}