---
title: "List current Ranking Sensor tasks"
method: GET
path: "/api/v1/tasks"
tags: ["Tasks"]
---

# List current Ranking Sensor tasks

`GET /api/v1/tasks`

## Request

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

Returns current, non-archived top-level task states from Ranking Sensor calibration snapshots. Use the children endpoint to retrieve implementation-level child tasks.

## 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`

Current individual Ranking Sensor task rows.

- TaskListResponse
  - `tasks` 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
  - `total` integer
  - `offset` integer
  - `pageSize` integer
  - `hasMore` boolean

---

[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)