---
title: "Get an individual Ranking Sensor task"
method: GET
path: "/api/v1/tasks/{taskId}"
tags: ["Tasks"]
---

# Get an individual Ranking Sensor task

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

## Request

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

Returns one current or archived task when it is visible to the authenticated customer.

## Path parameters

- `taskId` integer, required

## Response `200`

The requested individual task.

- 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

## Other responses

- `404`: The 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)