---
title: "Get task by id."
method: GET
path: "/ScheduledTasks/{taskId}"
tags: ["ScheduledTasks"]
---

# Get task by id.

`GET /ScheduledTasks/{taskId}`

## Path parameters

- `taskId` string, required — Task Id.

## Response `200`

Task retrieved.

- TaskInfo — Class TaskInfo.
  - `Name` string, nullable — Gets or sets the name.
  - `State` 'Idle' | 'Cancelling' | 'Running' — Enum TaskState.
  - `CurrentProgressPercentage` number, double, nullable — Gets or sets the progress.
  - `Id` string, nullable — Gets or sets the id.
  - `LastExecutionResult` TaskResult — Class TaskExecutionInfo.
    - `StartTimeUtc` string, date-time — Gets or sets the start time UTC.
    - `EndTimeUtc` string, date-time — Gets or sets the end time UTC.
    - `Status` 'Completed' | 'Failed' | 'Cancelled' | 'Aborted' — Enum TaskCompletionStatus.
    - `Name` string, nullable — Gets or sets the name.
    - `Key` string, nullable — Gets or sets the key.
    - `Id` string, nullable — Gets or sets the id.
    - `ErrorMessage` string, nullable — Gets or sets the error message.
    - `LongErrorMessage` string, nullable — Gets or sets the long error message.
  - `Triggers` TaskTriggerInfo[], nullable — Gets or sets the triggers.
    - `Type` string, nullable — Gets or sets the type.
    - `TimeOfDayTicks` integer, nullable — Gets or sets the time of day.
    - `IntervalTicks` integer, nullable — Gets or sets the interval.
    - `DayOfWeek` 'Sunday' | 'Monday' | 'Tuesday' | 'Wednesday' | 'Thursday' | 'Friday' | 'Saturday'
    - `MaxRuntimeTicks` integer, nullable — Gets or sets the maximum runtime ticks.
  - `Description` string, nullable — Gets or sets the description.
  - `Category` string, nullable — Gets or sets the category.
  - `IsHidden` boolean — Gets or sets a value indicating whether this instance is hidden.
  - `Key` string, nullable — Gets or sets the key.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Task not found.

---

[API](https://skmtc.net/jellyfin/apis/jellyfin-api.md) · [All operations](https://skmtc.net/jellyfin/apis/jellyfin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jellyfin/jellyfin-api/revisions/eb6f75af7066/schema)