# List folders (/docs/api/folders/list-folders)

## OpenAPI

```json
{
  "info": {
    "description": "The Circleback public REST API provides programmatic access to your meetings, notes, action items, transcripts, and more. Authenticate every request by sending your API key as a bearer token.",
    "title": "Circleback Public API",
    "version": "1.0.0"
  },
  "openapi": "3.2.0",
  "servers": [
    {
      "url": "https://circleback.ai/api"
    }
  ],
  "components": {
    "securitySchemes": {
      "ApiKeyAuth": {
        "bearerFormat": "cb_<secret>",
        "scheme": "bearer",
        "type": "http"
      }
    }
  },
  "tags": [
    {
      "description": "See the folders that organize meetings, who can read them, and the rules that file meetings into them.",
      "name": "Folders"
    }
  ],
  "paths": {
    "/folder": {
      "get": {
        "description": "Returns the folders the authenticated user can see, including closed folders they haven't joined and, for workspace admins, their workspace's hidden folders.",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "additionalProperties": false,
                    "example": {
                      "id": "k3Lm9QpR2sTvWx7Yz4AbC",
                      "name": "Customers",
                      "url": "https://circleback.ai/folders/k3Lm9QpR2sTvWx7Yz4AbC",
                      "access": "Editor",
                      "canAddMeetings": true,
                      "canReadMeetings": true,
                      "color": "bg-tag-blue",
                      "icon": "briefcase",
                      "isInvited": false,
                      "isMember": true,
                      "isRequestingToJoin": false,
                      "type": "Shared",
                      "visibility": "Closed",
                      "workspaceId": 1
                    },
                    "properties": {
                      "id": {
                        "description": "The unique identifier of the folder.",
                        "minLength": 1,
                        "type": "string"
                      },
                      "name": {
                        "description": "The display name of the folder.",
                        "type": "string"
                      },
                      "url": {
                        "description": "The link to the folder in Circleback.",
                        "type": "string"
                      },
                      "access": {
                        "anyOf": [
                          {
                            "enum": [
                              "Owner",
                              "Editor",
                              "Viewer",
                              "LimitedViewer"
                            ],
                            "type": "string"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "The access you get to the folder's meetings, or null when you can't read them."
                      },
                      "canAddMeetings": {
                        "description": "Whether your meetings can be filed into the folder.",
                        "type": "boolean"
                      },
                      "canReadMeetings": {
                        "description": "Whether you can read the folder's meetings.",
                        "type": "boolean"
                      },
                      "color": {
                        "anyOf": [
                          {
                            "type": "string"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "The color of the folder icon, or null for the default."
                      },
                      "icon": {
                        "anyOf": [
                          {
                            "type": "string"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "The icon shown for the folder."
                      },
                      "isInvited": {
                        "description": "Whether you were invited to the folder and have not answered yet.",
                        "type": "boolean"
                      },
                      "isMember": {
                        "description": "Whether you are a member of the folder, directly or through a team.",
                        "type": "boolean"
                      },
                      "isRequestingToJoin": {
                        "description": "Whether you asked to join the folder and are waiting for an answer.",
                        "type": "boolean"
                      },
                      "visibility": {
                        "anyOf": [
                          {
                            "enum": [
                              "Closed",
                              "Private"
                            ],
                            "type": "string"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Who can find the folder. Closed folders are listed to everyone in the workspace, and Private folders only to their members and workspace admins. Null for Default folders."
                      },
                      "workspaceId": {
                        "description": "The unique identifier of the workspace the folder belongs to.",
                        "exclusiveMinimum": 0,
                        "type": "number"
                      },
                      "type": {
                        "description": "The kind of folder. A Default folder catches the workspace's meetings that no other folder does. The PersonalPrivate folder is your Private folder, with the ID private, and holds your meetings that are in no folder. Shared folders are made by people in the workspace.",
                        "enum": [
                          "Default",
                          "PersonalPrivate",
                          "Shared"
                        ],
                        "type": "string"
                      }
                    },
                    "required": [
                      "id",
                      "name",
                      "icon",
                      "color",
                      "type",
                      "visibility",
                      "workspaceId",
                      "url",
                      "isMember",
                      "isInvited",
                      "isRequestingToJoin",
                      "access",
                      "canReadMeetings",
                      "canAddMeetings"
                    ],
                    "type": "object"
                  },
                  "type": "array"
                }
              }
            },
            "description": "Successful response."
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "code": {
                      "description": "A machine-readable code identifying the type of failure.",
                      "type": "string"
                    },
                    "error": {
                      "description": "A human-readable message explaining why the request failed.",
                      "type": "string"
                    },
                    "seatsToAdd": {
                      "description": "The authoritative number of workspace seats required.",
                      "exclusiveMinimum": 0,
                      "type": "integer"
                    },
                    "issues": {
                      "description": "The field-level validation issues found in an invalid request.",
                      "items": {
                        "additionalProperties": false,
                        "properties": {
                          "message": {
                            "description": "A human-readable explanation of the validation failure.",
                            "type": "string"
                          },
                          "path": {
                            "description": "The location of the request field that failed validation.",
                            "type": "string"
                          }
                        },
                        "required": [
                          "path",
                          "message"
                        ],
                        "type": "object"
                      },
                      "type": "array"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The request failed validation."
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/paths/~1folder/get/responses/400/content/application~1json/schema"
                }
              }
            },
            "description": "The request exceeded the rate limit for the account's plan, which the error message names: 3 requests per second and 20 per minute on Free, 20 per second and 300 per minute on Pro, Business, and Enterprise. Retry after the number of seconds in the `Retry-After` header."
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "summary": "List folders",
        "tags": [
          "Folders"
        ]
      }
    }
  }
}
```