---
title: "Query Folders fields history"
method: GET
path: "/folders/{folderIds}/folders_history"
tags: ["Folders & Projects"]
---

# Query Folders fields history

`GET /folders/{folderIds}/folders_history`

## Request

- Base URL: `https://www.wrike.com/api/v4`
- URL: `https://www.wrike.com/api/v4/folders/{folderIds}/folders_history`
- Auth: HTTP bearer

Query Folders fields history.

<b>Scopes:</b> Default, wsReadOnly, wsReadWrite

## Response `2XX`

success response

- object
  - `kind` 'accounts' | 'users' | 'contacts' | 'assets' | 'eDiscoveryReport' | 'folders' | 'folderTree' | 'tasks' | 'taskIds' | 'timelogs' | 'timelogCategories' | 'timelogLockPeriods' | 'timetrackerTimers' | 'comments' | 'attachments' | 'url' | 'version' | 'dataExport' | 'dataExportSchema' | 'auditLog' | 'accessRoles' | 'stream' | 'changes' | 'posts' | 'mailSettings' | 'integrationInfo' | 'gmailIntegrationSettings' | 'workTypesForIntegrations' | 'ids' | 'backups' | 'domains' | 'dependencies' | 'workflows' | 'workschedules' | 'workscheduleExclusions' | 'workscheduleUserExclusions' | 'customfields' | 'customfieldIds' | 'customstatuses' | 'invitations' | 'notifications' | 'jobroles' | 'placeholders' | 'groups' | 'session' | 'dashboards' | 'widgets' | 'taskCreationSettings' | 'colors' | 'experiments' | 'topics' | 'topicComments' | 'webhooks' | 'reviews' | 'boards' | 'textSearch' | 'chatChannels' | 'chatMessages' | 'forms' | 'requestForms' | 'request' | 'report' | 'platformWidgets' | 'platformWidgetInstances' | 'spaces' | 'pdf' | 'customerSatisfaction' | 'asyncJob' | 'approvals' | 'highlights' | 'highlightsList' | 'highlightsSettings' | 'highlightsCard' | 'timesheet' | 'timesheetRow' | 'timesheetSubmissionRule' | 'mobileFeatures' | 'mobileSettings' | 'folderBlueprintTree' | 'taskBlueprintTree' | 'blueprintSearch' | 'feedback' | 'timeline_snapshot' | 'contactIds' | 'bookings' | 'integrateThreshold' | 'hourlyRatesProvision' | 'hourlyRates' | 'projectTeamMembers' | 'contactsHistory' | 'tasksHistory' | 'foldersHistory' | 'activityDigest' | 'workItemTemplates' | 'workTemplates' | 'workItemMetadata' | 'workItem' | 'customItemTypes' | 'verificationCode' | 'views' | 'listView' | 'tableView' | 'userTypes' | 'reactions' | 'externalRequesters' | 'workscheduleCapacityOverrides' | 'userCapacityOverrides' | 'userCapacityExclusions' | 'rollups' | 'requestFormPrefill' | 'mcpFeatures' | 'attachmentUploadUrl' | 'userAggregatedCapacity' | 'cascadingFieldSettings' | 'recommendResources' | 'aggregatedAllocatedEffort' | 'aggregatedTotalUserEffort' | 'aggregatedTimeSpent' | 'folderBlueprint' | 'taskBlueprint'
  - `data` FolderChangeHistory[]
    - `project` FolderProjectHistory
      - `plannedCost` BudgetMetricHistoryItem[]: Planned cost change history
        - `endDate` string: Field's value for the selected end date<br>Format: yyyy-MM-dd'T'HH:mm:ss ('T'HH:mm:ss is optional)
        - `value` number, required: Field's value
        - `startDate` string, required: Field's value for the selected start date<br>Format: yyyy-MM-dd'T'HH:mm:ss ('T'HH:mm:ss is optional)
      - `plannedFees` BudgetMetricHistoryItem[]: Planned fees change history
        - `endDate` string: Field's value for the selected end date<br>Format: yyyy-MM-dd'T'HH:mm:ss ('T'HH:mm:ss is optional)
        - `value` number, required: Field's value
        - `startDate` string, required: Field's value for the selected start date<br>Format: yyyy-MM-dd'T'HH:mm:ss ('T'HH:mm:ss is optional)
      - `actualFees` BudgetMetricHistoryItem[]: Actual fees change history
        - `endDate` string: Field's value for the selected end date<br>Format: yyyy-MM-dd'T'HH:mm:ss ('T'HH:mm:ss is optional)
        - `value` number, required: Field's value
        - `startDate` string, required: Field's value for the selected start date<br>Format: yyyy-MM-dd'T'HH:mm:ss ('T'HH:mm:ss is optional)
      - `actualCost` BudgetMetricHistoryItem[]: Actual cost change history
        - `endDate` string: Field's value for the selected end date<br>Format: yyyy-MM-dd'T'HH:mm:ss ('T'HH:mm:ss is optional)
        - `value` number, required: Field's value
        - `startDate` string, required: Field's value for the selected start date<br>Format: yyyy-MM-dd'T'HH:mm:ss ('T'HH:mm:ss is optional)
      - `budget` BudgetMetricHistoryItem[]: Budget change history
        - `endDate` string: Field's value for the selected end date<br>Format: yyyy-MM-dd'T'HH:mm:ss ('T'HH:mm:ss is optional)
        - `value` number, required: Field's value
        - `startDate` string, required: Field's value for the selected start date<br>Format: yyyy-MM-dd'T'HH:mm:ss ('T'HH:mm:ss is optional)
    - `id` string

## Other responses

- `4XX`: client-side error response
- `5XX`: server-side error response

## Changes

- **2026-11-03** `7b0a63c547dd`: 9 warning
  - added the new `aggregatedAllocatedEffort` enum value to the `kind` response property for the response status `2XX`
  - added the new `aggregatedTimeSpent` enum value to the `kind` response property for the response status `2XX`
  - added the new `aggregatedTotalUserEffort` enum value to the `kind` response property for the response status `2XX`
  - added the new `attachmentUploadUrl` enum value to the `kind` response property for the response status `2XX`
  - …5 more

[Operation history](https://skmtc.dev/wrike/apis/wrike-api/changes/folders/:folderIds/folders_history/get.md)

---

[API](https://skmtc.dev/wrike/apis/wrike-api.md) - [All operations](https://skmtc.dev/wrike/apis/wrike-api/llms.txt) - [OpenAPI document](https://skmtc.dev/wrike/apis/wrike-api/revisions/7b0a63c547dd?raw)