---
updatedAt: 2026-02-24T14:46:00.000Z
agentTools:
  projectIndex: https://developers.wrike.com/llms.txt
---

# Get folders by ids

this resource is used to to get the list of folder with known IDs. It also allows to load the whole folders subtree in one query

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Wrike DataHub API",
    "description": "This is Wrike DataHub public API.\n\nThere are several distinct entities\n\nData folders (not to be confused with Wrike Folders) are meant for organizing databases and navigation\n\nDatabase store actual user data as records (database rows) and define (through metadata) the record structure.\nThe record structure is defined as a collection of Fields",
    "version": "0.1.1"
  },
  "servers": [
    {
      "url": "https://www.wrike.com/app/wrike_v2_web"
    },
    {
      "url": "https://app-eu.wrike.com/app/wrike_v2_web"
    },
    {
      "url": "https://app-us2.wrike.com/app/wrike_v2_web"
    }
  ],
  "security": [
    {
      "bearer-auth": []
    }
  ],
  "paths": {
    "/public/api/v1/folders": {
      "get": {
        "tags": [
          "Folders"
        ],
        "summary": "Get folders by ids",
        "description": "this resource is used to to get the list of folder with known IDs. It also allows to load the whole folders subtree in one query",
        "operationId": "findFolders",
        "parameters": [
          {
            "$ref": "#/components/parameters/Pagination"
          },
          {
            "$ref": "#/components/parameters/FoldersGetRequestMandatory"
          },
          {
            "$ref": "#/components/parameters/withDescendants"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FoldersResponse"
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "components": {
    "schemas": {
      "FoldersResponse": {
        "required": [
          "data",
          "total"
        ],
        "type": "object",
        "properties": {
          "total": {
            "type": "integer",
            "format": "int32"
          },
          "nextPageToken": {
            "type": "string"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ModuleResponse"
            }
          }
        }
      },
      "ModuleResponse": {
        "required": [
          "id",
          "title"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "parentFolderId": {
            "type": "string"
          }
        }
      }
    },
    "parameters": {
      "Pagination": {
        "name": "Pagination",
        "in": "query",
        "description": "Pagination parameter",
        "required": false,
        "schema": {
          "type": "object",
          "properties": {
            "nextPageToken": {
              "type": "string"
            },
            "limit": {
              "maximum": 1000,
              "minimum": 1,
              "type": "integer",
              "format": "int32",
              "default": 100
            }
          }
        }
      },
      "FoldersGetRequestMandatory": {
        "name": "folderIds",
        "in": "query",
        "description": "Folders filter parameter",
        "required": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "withDescendants": {
        "name": "withDescendants",
        "in": "query",
        "required": false,
        "schema": {
          "type": "boolean"
        }
      }
    },
    "securitySchemes": {
      "bearer-auth": {
        "type": "http",
        "description": "See details at [Wrike Developers Portal](https://developers.wrike.com/oauth-20-authorization/)",
        "scheme": "bearer",
        "bearerFormat": "JWT"
      }
    }
  }
}
```