---
title: "Get one task's calculation history by calibration period"
method: GET
path: "/api/v1/tasks/{taskId}/history"
tags: ["Tasks"]
---

# Get one task's calculation history by calibration period

`GET /api/v1/tasks/{taskId}/history`

## Request

- Base URL: `https://brew.marketbrew.ai/api/v1`
- URL: `https://brew.marketbrew.ai/api/v1/api/v1/tasks/{taskId}/history`
- Auth: API key in header `API-Key`

Returns immutable task progress observed after each Ranking Sensor calculation, grouped under the calibration that reset and governed that task period.

## Path parameters

- `taskId` integer, required

## Query parameters

- `boostFactorId` integer
- `endDate` string
- `offset` integer
- `pageSize` integer
- `rankingSensorId` integer
- `serverHost` string
- `snapshotId` integer
- `sortBy` string
- `sortDir` string
- `startDate` string
- `taskTitle` string
- `webpageId` integer
- `websiteId` integer
- `workspaceId` integer

## Response `200`

Task calculation history grouped by calibration period.

- TaskCalibrationHistoryResponse
  - `taskKey` string
  - `sourceTaskId` integer
  - `matchStrategy` 'STABLE_IDENTIFIERS' | 'TITLE_FALLBACK'
  - `currentTaskId` integer
  - `occurrenceCount` integer
  - `calibrationCount` integer
  - `calculationCount` integer
  - `historyAvailableFrom` string, date-time
  - `historyCompleteness` 'FULL' | 'LEGACY_DERIVED' | 'PARTIAL'
  - `calibrationPeriods` TaskCalibrationPeriodDTO[]
    - `calibrationSnapshotId` integer
    - `calibrationDate` string, date-time
    - `current` boolean
    - `calculationCount` integer
    - `firstSeenAt` string, date-time
    - `lastSeenAt` string, date-time
    - `startingProgressPercentage` integer
    - `endingProgressPercentage` integer
    - `calculations` TaskDTO[]
      - `taskId` integer
      - `taskKey` string
      - `parentTaskId` integer
      - `taskTitle` string
      - `summary` string
      - `description` string
      - `taskType` integer
      - `taskTypeLabel` string
      - `optimizationScore` number
      - `hoursRequired` number
      - `previousCompletionPercentage` integer
      - `completionPercentage` integer
      - `progressDelta` integer
      - `status` 'NOT_STARTED' | 'IN_PROGRESS' | 'COMPLETED'
      - `childCount` integer
      - `archived` boolean
      - `snapshotId` integer
      - `snapshotDate` string, date-time
      - `rankingSensorId` integer
      - `rankingSensorName` string
      - `correlationKeyword` string
      - `websiteId` integer
      - `webpageId` integer
      - `boostFactorId` integer
      - `serverHost` string
      - `pagePath` string
  - `firstSeenAt` string, date-time
  - `lastSeenAt` string, date-time
  - `currentProgressPercentage` integer
  - `occurrences` TaskDTO[]
    - `taskId` integer
    - `taskKey` string
    - `parentTaskId` integer
    - `taskTitle` string
    - `summary` string
    - `description` string
    - `taskType` integer
    - `taskTypeLabel` string
    - `optimizationScore` number
    - `hoursRequired` number
    - `previousCompletionPercentage` integer
    - `completionPercentage` integer
    - `progressDelta` integer
    - `status` 'NOT_STARTED' | 'IN_PROGRESS' | 'COMPLETED'
    - `childCount` integer
    - `archived` boolean
    - `snapshotId` integer
    - `snapshotDate` string, date-time
    - `rankingSensorId` integer
    - `rankingSensorName` string
    - `correlationKeyword` string
    - `websiteId` integer
    - `webpageId` integer
    - `boostFactorId` integer
    - `serverHost` string
    - `pagePath` string
  - `offset` integer
  - `pageSize` integer
  - `hasMore` boolean

## Other responses

- `404`: The source task does not exist or is outside the authenticated customer scope.

---

[API](https://skmtc.dev/marketbrew/apis/market-brew-api-documentation.md) · [All operations](https://skmtc.dev/marketbrew/apis/market-brew-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/marketbrew/apis/market-brew-api-documentation/revisions/11e3674a43d7?raw)