---
title: "Query Relay Pairing Result"
method: GET
path: "/openapi/v2.0/device/{device_sn}/relay_model"
tags: ["Device Management/Device Configuration/Pairing Management", "Device Management"]
---

# Query Relay Pairing Result

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

## Request

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

Query the relay pairing result of a specified relay device; returns the current pairing status code (0/1/2/3/65535). Supported only in private cloud and relay device scenarios

## 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: Business status code, 0 means success
  - `message` string, required: Business Message
  - `data` object, required: Business data, relay pairing result
    - `status` string, required: ok means the command was successfully dispatched, failed means dispatch failed
    - `output` object, required: output field
      - `status` 0 | 1 | 2 | 3 | 65535, required: Relay Pairing Status Code
    - `bid` string: Business order ID (relay pairing task identifier); returns empty string when pairing has not been triggered or is idle

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