---
title: "Get Flight Area List (Project Scope)"
method: GET
path: "/openapi/v2.0/flight-areas"
tags: ["Map/Airspace Safety/Custom Flight Area"]
---

# Get Flight Area List (Project Scope)

`GET /openapi/v2.0/flight-areas`

## Request

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

Query the custom flight area list by project; pilots can review the project's flight restriction zones before executing tasks

## Query parameters

- `name` string
- `type` 'dfence' | 'nfz' | 'noland'
- `status` 'enable' | 'disable'
- `page` integer
- `page_size` integer

## Headers

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

## Response `200`

success

- object
  - `code` integer: Business status code, 0 means success
  - `message` string: Business Message
  - `data` object: Flight Area List and Pagination Info
    - `list` object[], nullable: Flight area list, returns null when list is empty
      - `id` string: Flight Area UUID
      - `name` string: Flight area name, max 28 characters
      - `status` 'enable' | 'disable': Enabled status: enable, disable
      - `type` 'dfence' | 'nfz' | 'noland': Flight area business type: dfence=restricted flight zone, nfz=no-fly zone, noland=no-landing zone
      - `content` object: Region geometry info, GeoJSON Feature; geometry.type is one of Polygon/Circle/Point/Polyline
      - `area_hash` string: Region content hash (status_type_md5), used to determine whether the device's local cache needs to be updated
      - `created_time` integer: Created at, Unix milliseconds
      - `created_by` string: Creator User ID
      - `created_nickname` string: Creator Nickname
      - `updated_time` integer: Last updated time, Unix milliseconds
      - `updated_by` string: Last Updater User ID
      - `updated_nickname` string: Last Updater's Nickname
    - `pagination` object: Pagination Info
      - `page` integer: Current page, starts from 1
      - `page_size` integer: Items Per Page
      - `total` integer: Total Count

## Other responses

- `400`: Parameter Error
- `401`: Authentication Failed
- `403`: Insufficient Permission
- `404`: Resource Not Found
- `500`: Service Exception

---

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