---
title: "Get Thing Model"
method: GET
path: "/openapi/v2.0/device/{device_sn}/state"
tags: ["Device Management", "device-api"]
---

# Get Thing Model

`GET /openapi/v2.0/device/{device_sn}/state`

## Request

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

Get the thing model. By passing `device_sn`, retrieve the thing model information for the corresponding device.

:::tip[]
For more details about device thing model properties, refer to the device properties documentation in the [Cloud API](https://developer.dji.com/doc/cloud-api-tutorial/en/api-reference/dock-to-cloud/mqtt/dock/dock3/properties.html).
:::

## Path parameters

- `device_sn` string, required

## Headers

- `X-Request-Id` string, uuid
- `X-Language` 'zh' | 'en'
- `X-Project-Uuid` string, required
- `X-User-Token` string, required

## Response `200`

- object
  - `code` integer, required: Non-zero Indicates Exception
  - `message` string, required: Message Prompt
  - `data` object, required: Business data, device thing model snapshot
    - `device_sn` string, required: Device SN
    - `device_model` object, required: Device Model
      - `key` string, required: Key, device unique identifier composed of domain-type-sub_type. For detailed device types, refer to: https://developer.dji.com/doc/cloud-api-tutorial/en/overview/product-support.html
      - `domain` string, required: Domain
      - `type` string, required: Type
      - `sub_type` string, required: Sub-Type
      - `name` string, required: Device Model
      - `class` string, required: Device Category: Dock, Remote Controller, etc.
    - `device_state` union, required: Snapshot of device thing model properties. The structure varies completely by model and is determined by the device_model.key (domain-type-sub_type) in the response. The structure differentiates models by device_model.key (domain-type-sub_type) in the response
      - Dock201 (unresolved $ref)
      - Matrice203020Series (unresolved $ref)
      - Dock202 (unresolved $ref)
      - Matrice203D2020Series (unresolved $ref)
      - DJI20RC20Plus202 (unresolved $ref)
      - Matrice2042020Series (unresolved $ref)
      - DJI2020RC20Pro20Enterprise (unresolved $ref)
      - Mavic20320Enterprise20Series (unresolved $ref)
      - Matrice2035020RTK (unresolved $ref)
      - Matrice2030020RTK (unresolved $ref)
      - DJI20Smart20Controller20Enterprise (unresolved $ref)
      - DJI20RC20Plus (unresolved $ref)

## Other responses

- `400`: Invalid request parameters (incorrect format, missing required fields, etc.)
- `401`: Authentication failed (token invalid or expired)
- `403`: Insufficient permission (token does not have the corresponding permission in this project/organization)
- `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)