# Get folder (/docs/api/folders/get-folder-get-folderfolderid)

## 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/{folderId}": {
      "get": {
        "description": "Returns folders with their members, teams, and rules. Pending invitations are only listed to people who manage the folder.",
        "parameters": [
          {
            "description": "The unique identifier of the folder.",
            "in": "path",
            "name": "folderId",
            "required": true,
            "schema": {
              "minLength": 1,
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "example": {
                    "id": "k3Lm9QpR2sTvWx7Yz4AbC",
                    "name": "Customers",
                    "url": "https://circleback.ai/folders/k3Lm9QpR2sTvWx7Yz4AbC",
                    "canManage": true,
                    "color": "bg-tag-blue",
                    "icon": "briefcase",
                    "type": "Shared",
                    "visibility": "Closed",
                    "workspaceId": 1,
                    "invitations": [
                      {
                        "profileId": 2,
                        "name": "Samantha Grey",
                        "access": "Viewer",
                        "email": "samantha@initech.com"
                      }
                    ],
                    "joinRequests": [],
                    "members": [
                      {
                        "profileId": 1,
                        "name": "John Appleseed",
                        "access": "Editor",
                        "email": "john@initech.com",
                        "isContributor": true,
                        "isOwner": true,
                        "userId": 1,
                        "teamIds": [],
                        "workspaceIds": []
                      }
                    ],
                    "ruleGroups": [
                      {
                        "conditions": [
                          {
                            "operator": "Contains",
                            "type": "MeetingName",
                            "value": "Initech"
                          }
                        ]
                      }
                    ],
                    "teams": [
                      {
                        "access": "Viewer",
                        "isContributor": false,
                        "teamId": 1
                      }
                    ],
                    "workspaces": []
                  },
                  "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"
                    },
                    "canManage": {
                      "description": "Whether you can change the folder, its rules, and its members.",
                      "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."
                    },
                    "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"
                    },
                    "invitations": {
                      "description": "People invited to add their meetings who have not accepted yet, with the access accepting gives them. Only listed to people who manage the folder.",
                      "items": {
                        "additionalProperties": false,
                        "properties": {
                          "profileId": {
                            "description": "The unique identifier of their profile.",
                            "exclusiveMinimum": 0,
                            "type": "number"
                          },
                          "name": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "The name of the user."
                          },
                          "access": {
                            "anyOf": [
                              {
                                "enum": [
                                  "Owner",
                                  "Editor",
                                  "Viewer",
                                  "LimitedViewer"
                                ],
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "The access they get to the folder's meetings, or null when they can't read them."
                          },
                          "email": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "The email address of the user."
                          }
                        },
                        "required": [
                          "name",
                          "email",
                          "access",
                          "profileId"
                        ],
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "invitedPeople": {
                      "description": "People without an account who were added by email, with the access they get when they sign up. Only listed to people who manage the folder.",
                      "items": {
                        "additionalProperties": false,
                        "properties": {
                          "profileId": {
                            "description": "The unique identifier of their profile.",
                            "exclusiveMinimum": 0,
                            "type": "number"
                          },
                          "access": {
                            "anyOf": [
                              {
                                "enum": [
                                  "Owner",
                                  "Editor",
                                  "Viewer",
                                  "LimitedViewer"
                                ],
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "The access they get to the folder's meetings, or null when they can't read them."
                          },
                          "email": {
                            "description": "The email address they were invited at.",
                            "type": "string"
                          },
                          "isContributor": {
                            "description": "Whether the folder's rules file their matching meetings, for people in the folder's workspace. People outside it need this to add their meetings by hand; people inside can add theirs either way.",
                            "type": "boolean"
                          }
                        },
                        "required": [
                          "profileId",
                          "email",
                          "access",
                          "isContributor"
                        ],
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "joinRequests": {
                      "description": "People who asked to join the folder. Only listed to people who manage the folder.",
                      "items": {
                        "additionalProperties": false,
                        "properties": {
                          "profileId": {
                            "description": "The unique identifier of their profile.",
                            "exclusiveMinimum": 0,
                            "type": "number"
                          },
                          "name": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "The name of the user."
                          },
                          "email": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "The email address of the user."
                          }
                        },
                        "required": [
                          "profileId",
                          "name",
                          "email"
                        ],
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "members": {
                      "description": "The people who can read or add to the folder.",
                      "items": {
                        "additionalProperties": false,
                        "properties": {
                          "profileId": {
                            "description": "The unique identifier of the member profile.",
                            "exclusiveMinimum": 0,
                            "type": "number"
                          },
                          "name": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "The name of the user."
                          },
                          "access": {
                            "anyOf": [
                              {
                                "enum": [
                                  "Owner",
                                  "Editor",
                                  "Viewer",
                                  "LimitedViewer"
                                ],
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "The access they get to the folder's meetings, or null when they can't read them."
                          },
                          "email": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "The email address of the user."
                          },
                          "isContributor": {
                            "description": "Whether the folder's rules file their matching meetings, for people in the folder's workspace. People outside it need this to add their meetings by hand; people inside can add theirs either way.",
                            "type": "boolean"
                          },
                          "isOwner": {
                            "description": "Whether they own the folder and can manage it.",
                            "type": "boolean"
                          },
                          "userId": {
                            "description": "The unique identifier of the user.",
                            "exclusiveMinimum": 0,
                            "type": "number"
                          },
                          "teamIds": {
                            "description": "The teams that give the member access.",
                            "items": {
                              "exclusiveMinimum": 0,
                              "type": "number"
                            },
                            "type": "array"
                          },
                          "workspaceIds": {
                            "description": "The workspaces that give the member access.",
                            "items": {
                              "exclusiveMinimum": 0,
                              "type": "number"
                            },
                            "type": "array"
                          }
                        },
                        "required": [
                          "userId",
                          "name",
                          "email",
                          "access",
                          "profileId",
                          "isContributor",
                          "isOwner",
                          "teamIds",
                          "workspaceIds"
                        ],
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "ruleGroups": {
                      "description": "The rules that file new meetings into the folder. A meeting matches when any group matches, and a group matches when all its conditions do.",
                      "items": {
                        "additionalProperties": false,
                        "properties": {
                          "conditions": {
                            "items": {
                              "additionalProperties": false,
                              "properties": {
                                "operator": {
                                  "description": "Each type allows only some operators.",
                                  "enum": [
                                    "Include",
                                    "DoNotInclude",
                                    "AreAll",
                                    "AreNotAll",
                                    "Is",
                                    "IsNot",
                                    "Contains",
                                    "DoesNotContain",
                                    "GreaterThan",
                                    "LessThan"
                                  ],
                                  "type": "string"
                                },
                                "type": {
                                  "enum": [
                                    "Tags",
                                    "MeetingName",
                                    "Participants",
                                    "InviteeEmails",
                                    "InviteeEmailDomains",
                                    "NumberOfInvitees",
                                    "EveryMeeting"
                                  ],
                                  "type": "string"
                                },
                                "value": {
                                  "description": "For Tags, a tag ID.",
                                  "minLength": 1,
                                  "type": "string"
                                }
                              },
                              "required": [
                                "type",
                                "operator",
                                "value"
                              ],
                              "type": "object"
                            },
                            "minItems": 1,
                            "type": "array"
                          }
                        },
                        "required": [
                          "conditions"
                        ],
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "teams": {
                      "description": "The teams that can read or add to the folder.",
                      "items": {
                        "additionalProperties": false,
                        "properties": {
                          "access": {
                            "anyOf": [
                              {
                                "enum": [
                                  "Owner",
                                  "Editor",
                                  "Viewer",
                                  "LimitedViewer"
                                ],
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "The access they get to the folder's meetings, or null when they can't read them."
                          },
                          "isContributor": {
                            "description": "Whether the folder's rules file their matching meetings, for people in the folder's workspace. People outside it need this to add their meetings by hand; people inside can add theirs either way.",
                            "type": "boolean"
                          },
                          "teamId": {
                            "description": "The unique identifier of the team.",
                            "exclusiveMinimum": 0,
                            "type": "number"
                          }
                        },
                        "required": [
                          "teamId",
                          "access",
                          "isContributor"
                        ],
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "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"
                    },
                    "workspaces": {
                      "description": "The workspaces whose active members can read or add to the folder.",
                      "items": {
                        "additionalProperties": false,
                        "properties": {
                          "access": {
                            "anyOf": [
                              {
                                "enum": [
                                  "Owner",
                                  "Editor",
                                  "Viewer",
                                  "LimitedViewer"
                                ],
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "The access they get to the folder's meetings, or null when they can't read them."
                          },
                          "isContributor": {
                            "description": "Whether the folder's rules file their matching meetings, for people in the folder's workspace. People outside it need this to add their meetings by hand; people inside can add theirs either way.",
                            "type": "boolean"
                          },
                          "workspaceId": {
                            "description": "The unique identifier of the workspace.",
                            "exclusiveMinimum": 0,
                            "type": "number"
                          }
                        },
                        "required": [
                          "workspaceId",
                          "access",
                          "isContributor"
                        ],
                        "type": "object"
                      },
                      "type": "array"
                    }
                  },
                  "required": [
                    "id",
                    "name",
                    "icon",
                    "color",
                    "type",
                    "visibility",
                    "workspaceId",
                    "url",
                    "canManage",
                    "members",
                    "invitations",
                    "joinRequests",
                    "invitedPeople",
                    "ruleGroups",
                    "teams",
                    "workspaces"
                  ],
                  "type": "object"
                }
              }
            },
            "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~1{folderId}/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": "Get folder",
        "tags": [
          "Folders"
        ]
      }
    }
  }
}
```