---
title: "Get Flight Task Information"
method: GET
path: "/openapi/v2.0/flight-task/{task_uuid}"
tags: ["Flight Task/Task Query"]
---

# Get Flight Task Information

`GET /openapi/v2.0/flight-task/{task_uuid}`

## Request

- Base URL: `` (relative, and it does not resolve against the document’s source URL)
- URL: `/openapi/v2.0/flight-task/{task_uuid}`
- Auth: none required

Get flight task information. After a wayline task is started, you can use this interface to retrieve task information, runtime status, and information about media files produced by the task

## Path parameters

- `task_uuid` string, uuid, required

## Query parameters

- `workspace_id` string, uuid, required

## Headers

- `X-User-Token` string, required
- `X-Project-Uuid` string, required
- `X-Request-Id` string
- `X-Language` string

## Response `200`

Success

- object
  - `code` integer: Non-zero Indicates Exception
  - `message` string: Message Prompt
  - `data` object: Flight Task Details
    - `uuid` string, uuid: Task UUID
    - `name` string: Task Name
    - `task_type` 'immediate' | 'timed' | 'recurring' | 'continuous': Task type: currently only immediate tasks are supported
    - `status` 'waiting' | 'starting_failure' | 'executing' | 'paused' | 'terminated' | 'success' | 'suspended' | 'timeout' | 'partially_done': status field
    - `sn` string: Dock SN
    - `wayline_uuid` string, uuid: Wayline UUID
    - `begin_at` string, date-time: Task Planned Execution Time
    - `end_at` string, date-time: Task Planned End Time
    - `out_of_control_action_in_flight` 'return_home' | 'continue_task': UAV Action After Signal Loss
    - `rth_altitude` integer: Return-to-Home Altitude
    - `rth_mode` 'optimal' | 'preset': Return-to-Home Mode
    - `resumable_status` 'auto' | 'manual': Auto Resume from Breakpoint
    - `repeat_type` 'nonrepeating' | 'daily' | 'weekly' | 'absolute_monthly' | 'relative_monthly': Task Repetition Mode
    - `interval` integer: Repeat interval: minimum 1
    - `days_of_week` integer[]: Weekly execution day array, day of week, 0-6, 0=Sunday, 1=Monday
    - `days_of_month` integer[]: Monthly execution day array, day of month, 1-31
    - `week_of_month` integer: Week of the month, 1-4
    - `recurring_task_start_time_list` integer[]: Multiple Execution Times for Repeat Tasks, seconds-level timestamps
    - `continuous_task_periods` array[]: Multiple Execution Periods of Continuous Task
      - integer[]
    - `min_battery_capacity` integer: Minimum Battery Level for Continuous Execution
    - `folder_info` object: Task Media Folder Info
      - `folder_id` integer: Resource Folder ID
      - `expected_file_count` integer: Number of Media Generated by Task
      - `uploaded_file_count` integer: Number of Media Uploaded to FlightHub

## Other responses

- `401`: Login Expired
- `404`: Task Not Found
- `500`: Server Internal Error

---

[API](https://skmtc.dev/dji/apis/flighthub-2-openapi-v2-0-public-cloud.md) - [All operations](https://skmtc.dev/dji/apis/flighthub-2-openapi-v2-0-public-cloud/llms.txt) - [OpenAPI document](https://skmtc.dev/dji/apis/flighthub-2-openapi-v2-0-public-cloud/revisions/aeef0010be34?raw)