---
title: "Get Stream Converter List"
method: GET
path: "/openapi/v2.0/stream-converters"
tags: ["Livestream/Livestream Sharing & Forwarding/Bypass Streaming"]
---

# Get Stream Converter List

`GET /openapi/v2.0/stream-converters`

## Request

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

Get the stream converter list under the current organization, supporting filters by Device SN, camera index, protocol, and enabled status

## Query parameters

- `device_sn` string
- `camera_index` string
- `schema` string
- `enable` boolean
- `page` integer
- `page_size` integer

## Headers

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

## Response `200`

Business call succeeded (the business status code is determined by the `code` field)

- object
  - `code` integer: Non-zero Indicates Exception
  - `message` string: Message Prompt
  - `data` object: Business Data
    - `pagination` object: Pagination Info
      - `page` integer: Current Page
      - `page_size` integer: Page Size
      - `total` integer: Total Count
    - `list` object[]: Stream Converter List
      - `converter_id` string: Stream Converter ID
      - `converter_name` string: Converter Name
      - `sn` string: Source Device SN
      - `camera` string: Camera Index
      - `video` string: Stream identifier, fixed normal-0
      - `video_type` string: Lens type, e.g., wide / zoom / ir
      - `schema` 'rtmp' | 'gb28181' | 'rtsp': Streaming Protocol
      - `bypass_option` object: Streaming protocol parameters (use the corresponding field per schema)
        - `url` string: RTMP Push URL
        - `server_id` string: GB28181 SIP Server ID
        - `server_ip` string: GB28181 SIP Server IP
        - `server_port` string: GB28181 SIP Server Port
        - `device_password` string: GB28181 Registration Password
        - `local_port` string: GB28181 Local Port
        - `device_id` string: GB28181 Device ID
        - `local_channel` string: GB28181 Local Channel
        - `rtsp_url` string: RTSP Pull URL
        - `username` string: RTSP Username
        - `password` string: RTSP Password
        - `enable_ts` integer, nullable: Streaming Start Timestamp
      - `auto_push_stream` boolean: Whether In Auto-Streaming (Enabled) State
      - `device_online_status` boolean: Source Device Online Status
      - `device_callsign` string: Source Device Alias
      - `state` string: Converter running status, e.g., initialized / running / stopped
      - `code` integer: Status code, non-zero indicates exception
      - `update_ts` string: Last Updated Timestamp

## Other responses

- `401`: Token missing or invalid
- `403`: No Permission to Access This Resource
- `404`: Resource Not Found
- `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)