---
title: "Get Organization List"
method: GET
path: "/openapi/v2.0/organizations"
tags: ["Organization & Project/Organization Management/Organization Basic Info"]
---

# Get Organization List

`GET /openapi/v2.0/organizations`

## Request

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

Query all organizations the current user has joined (for organization selector / switch page); supports both paginated and full-list usage

## Query parameters

- `q` string
- `org_status` string
- `org_user_role` string
- `sort_column` string
- `sort_type` string
- `page` integer
- `page_size` integer

## Headers

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

## Response `200`

Business success (see 'Response Example' in the Markdown documentation for specific data)

- object
  - `code` integer: Non-zero Indicates Exception
  - `message` string: Message Prompt
  - `data` object: Business Data
    - `pagination` object: Pagination Info
      - `page` integer: Current page number, starts from 1
      - `page_size` integer: Items Per Page
      - `total` integer: Total Count
    - `list` object[]: List of Organizations User Has Joined
      - `name` string: Organization Name
      - `uuid` string, uuid: Organization UUID
      - `organization_id` string: Organization Short Code (human-readable invite code)
      - `created_at` integer: Organization created at, seconds-level Unix timestamp
      - `updated_at` integer: Updated at, seconds-level Unix timestamp
      - `status` string: Organization status: organization-status-run, etc.; may be empty string in details interface
      - `organization_device_bind_code` object: Organization Device Binding Code (used for scanning to bind devices)
        - `code` string: Device Binding Code
      - `organization_industry_type` object: Industry Classification
        - `type` string: Primary Industry Code
        - `sub_type` string: Secondary Industry Code
        - `others` string: Free-form Remark
      - `organization_units_system` object: Organization Default Unit System
        - `measure_units_system` string: metric/imperial
        - `temperature_units_system` string: celsius/fahrenheit
      - `user_experience_improvement` object: User Experience Improvement Program Switch
        - `version` string: Current Protocol Version
        - `improvement_type` integer: Type Enum
        - `latest_version` string: Latest Protocol Version
      - `organization_geo_caging_system` object: Organization Geofence Configuration
        - `geo_caging_state` integer: Status Enum
      - `current_zone_id` string: Current zone identifier; empty string if not specified
      - `mfa_enabled` boolean: Whether MFA Is Enabled
      - `logo_id` string, nullable: Organization LOGO file id; may not be returned by the details endpoint
      - `organization_user_role` string: Current User's Role in This Organization
      - `organization_user_callsign` string: Current User's Callsign in This Organization
      - `join_organization_at` integer: Time user joined this organization, seconds-level Unix timestamp

## Other responses

- `401`: Login expired or Authorization not provided
- `403`: Account does not have permission to access this resource
- `500`: Service temporarily unavailable, please retry later

---

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