# Get folder (deprecated)

Gets a Folder object.

> Important: We've set a 60 requests per minute per API token limit for this operation.

DEPRECATED - As early as the sunset date specified in this Changelog entry, this endpoint will be removed. See the Get folder metadata and the List folder children endpoints for replacement functionality.

Endpoint: GET /folders/{folderId}
Version: 2.0.0
Security: APIToken, OAuth2

## Header parameters:

  - `Authorization` (string)
    API Access Token used to authenticate requests to Smartsheet APIs.

  - `smartsheet-integration-source` (string)
    Uses the following metadata to distinguish between human-initiated API requests and third-party service-initiated calls by AI Connectors or ITSM:

- Integration source type
- Organization name
- Integration source name 

Format:


TYPE,OrgName,SourceName


Examples: 

AI,SampleOrg,My-AI-Connector-v2

SCRIPT,SampleOrg2,Accounting-updater-script

APPLICATION,SampleOrg3,SheetUpdater
    Example: "AI,SampleOrg,My-AI-Connector-v2"

## Path parameters:

  - `folderId` (number, required)
    ID of the folder being accessed.

## Query parameters:

  - `include` (string)
    A comma-separated list of optional elements to include in the response:
  * source - adds the Source object indicating which object the folder was created from, if any
  * distributionLink
  * ownerInfo Returns the user with owner permissions, or the user with admin permissions if there is no owner assigned. If no owner or admins are assigned, the Plan Asset Admin is returned. If no Plan Asset Admin is assigned, the System Admin is returned.
  * sheetVersion
  * permalinks
    Enum: "source", "distributionLink", "ownerInfo", "sheetVersion"

## Response 200 fields (application/json):

  - `id` (number)
    Folder ID.

  - `folders` (array)
    Folders contained in folder.

  - `name` (string)
    Folder name.

  - `permalink` (string)
    URL that represents a direct link to the folder in Smartsheet.

  - `reports` (array)
    Reports contained in folder.

  - `reports.id` (number)
    Asset ID.

  - `reports.name` (string)
    Asset name.

  - `reports.permalink` (string)
    URL that represents a direct link to the asset in Smartsheet.

  - `sheets` (array)
    Sheets contained in folder.

  - `sights` (array)
    Dashboards contained in folder.

  - `sights.createdAt` (any)

  - `sights.modifiedAt` (any)

  - `templates` (array)
    Templates contained in folder.

  - `favorite` (boolean)
    Deprecated Returned only if the user has marked the folder as a favorite in their "Home" tab (value = true).

## Response default fields (application/json):

  - `refId` (string)
    The ID of the specific error occurrence. Please include this information when contacting Smartsheet support.

  - `errorCode` (number)
    Custom error code from Smartsheet. See the complete [Error Code List](/api/smartsheet/error-codes).

  - `message` (string)
    Descriptive error message.