# List collections

> Get a paginated list of collections for an organization.
Use `type` query param to filter by collection type (folder or playlist).

```json
{
  "/collections": {
    "get": {
      "tags": [
        "Collections"
      ],
      "summary": "List collections",
      "operationId": "listCollection",
      "description": "Get a paginated list of collections for an organization.\nUse `type` query param to filter by collection type (folder or playlist).",
      "security": [
        {
          "bearerAuth": []
        }
      ],
      "responses": {
        "200": {
          "description": "List of collections with pagination",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "data": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$",
                          "format": "uuid"
                        },
                        "name": {
                          "type": "string"
                        },
                        "description": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "thumbnailUrl": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "organizationId": {
                          "type": "string",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$",
                          "format": "uuid"
                        },
                        "type": {
                          "type": "string",
                          "enum": [
                            "folder",
                            "playlist"
                          ]
                        },
                        "isPublic": {
                          "type": "boolean"
                        },
                        "videoCount": {
                          "anyOf": [
                            {
                              "type": "number"
                            },
                            {
                              "type": "string",
                              "enum": [
                                "Infinity",
                                "-Infinity",
                                "NaN"
                              ]
                            }
                          ]
                        },
                        "createdAt": {
                          "type": "string"
                        },
                        "updatedAt": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "id",
                        "name",
                        "description",
                        "thumbnailUrl",
                        "organizationId",
                        "type",
                        "isPublic",
                        "videoCount",
                        "createdAt",
                        "updatedAt"
                      ],
                      "additionalProperties": true
                    }
                  },
                  "pagination": {
                    "type": "object",
                    "properties": {
                      "page": {
                        "anyOf": [
                          {
                            "type": "number"
                          },
                          {
                            "type": "string",
                            "enum": [
                              "Infinity",
                              "-Infinity",
                              "NaN"
                            ]
                          }
                        ]
                      },
                      "limit": {
                        "anyOf": [
                          {
                            "type": "number"
                          },
                          {
                            "type": "string",
                            "enum": [
                              "Infinity",
                              "-Infinity",
                              "NaN"
                            ]
                          }
                        ]
                      },
                      "total": {
                        "anyOf": [
                          {
                            "type": "number"
                          },
                          {
                            "type": "string",
                            "enum": [
                              "Infinity",
                              "-Infinity",
                              "NaN"
                            ]
                          }
                        ]
                      },
                      "totalPages": {
                        "anyOf": [
                          {
                            "type": "number"
                          },
                          {
                            "type": "string",
                            "enum": [
                              "Infinity",
                              "-Infinity",
                              "NaN"
                            ]
                          }
                        ]
                      }
                    },
                    "required": [
                      "page",
                      "limit",
                      "total",
                      "totalPages"
                    ],
                    "additionalProperties": true
                  }
                },
                "required": [
                  "data",
                  "pagination"
                ],
                "additionalProperties": true
              }
            }
          }
        },
        "400": {
          "description": "- Invalid request parameters"
        },
        "401": {
          "description": "- Unauthorized"
        },
        "403": {
          "description": "- Not a member of the organization"
        }
      }
    }
  }
}
```
