---
title: "Get Flight Task List"
method: GET
path: "/openapi/v2.0/flight-task/list"
tags: ["Flight Task/Task Query"]
---

# Get Flight Task List

`GET /openapi/v2.0/flight-task/list`

## Request

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

Get the project's flight task list with filters by time, SN, status, name, etc. Currently returns the first 100 entries; use filter parameters to narrow the result set as needed

## Query parameters

- `sn` string
- `name` string
- `begin_at` string
- `end_at` string
- `task_type` string
- `status` string
- `flight_task_type` string

## Headers

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

## Response `200`

Success

- object
  - `code` integer: Non-zero Indicates Exception
  - `message` string: Message Prompt
  - `data` object: Paginated Flight Task Result
    - `list` object[]: Flight Task List
      - `uuid` string, uuid: Task Unique Identifier
      - `name` string: Task Name
      - `task_type` 'immediate' | 'timed' | 'recurring' | 'continuous': Task type: immediate / timed / recurring / continuous
      - `status` 'waiting' | 'starting_failure' | 'executing' | 'paused' | 'terminated' | 'success' | 'suspended' | 'timeout' | 'partially_done' | 'preparing' | 'queue_for_takeoff': Task Status
      - `sn` string: Takeoff Dock SN
      - `landing_dock_sn` string: Landing Dock SN (A->B task)
      - `wayline_uuid` string, uuid: Associated Wayline UUID
      - `begin_at` string, date-time: Planned Start Time
      - `end_at` string, date-time: Planned End Time
      - `run_at` string, date-time: Actual Start Execution Time
      - `completed_at` string, date-time: Actual Completion Time
      - `media_upload_status` 'to_upload' | 'uploading' | 'upload_finished': Media upload status: to_upload / uploading / upload_finished
      - `resumable_status` 'auto' | 'manual': Resume-from-breakpoint mode: auto / manual
      - `is_break_point_resume` boolean: Whether It Is a Resume-from-Breakpoint Task
      - `current_waypoint_index` integer: Completed Waypoint Count
      - `total_waypoints` integer: Total Waypoints
      - `flight_type` string: Flight type, 1: automatic task; 2: manual task
      - `flight_status` string: Completion status, 1: incomplete; 2: completed
      - `folder_id` integer: Folder ID Associated with Task
      - `operations` object[]: User List Who Performed Operations on This Task
        - `operator_account` string: Operator Account
      - `exceptions` object[]: List of Exceptions Occurring During Task Execution
        - `code` integer: Exception Error Code
        - `message` string: Exception Description
        - `happen_at` string, date-time, nullable: Exception occurrence time (RFC3339 format)
        - `sn` string: Device SN Where Exception Occurred

## Other responses

- `401`: Login Expired
- `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)