---
title: LDWS Info Endpoints
slug: develop/ldws-info-endpoints
docTags: 
createdAt: 2025-03-11T07:03:32.131Z
---

## GET /v1/info/ 

Returns basic player information

**Request Example**

```text
GET /api/v1/info/ HTTP/1.1
Host: {{playerIP}
Authorization: {{DigestAuth}}
```

**Response Body**

- `serial` <font color="#704ae0">string</font>: The serial number of the player
- `model` <font color="#704ae0">string</font>: The model number of the device (e.g. "XD234")
- `connectionType` <font color="#704ae0">string</font>: The currently active network interface, which can be either "Ethernet" or "WiFi"
- `ethernet` <font color="#704ae0">object</font>: An object containing information about the ethernet connection. This property will only be available if there's a valid ethernet connection on the player. The object can contain the following properties:
  - `IPv4` <font color="#704ae0">object</font>: An object containing information about the IPv4 configuration. The object can contain the following properties:
    - `address` <font color="#704ae0">string</font>: The assigned IPv4 address
    - `netmask` <font color="#704ae0">string</font>: The IPv4 network mask
    - `family` <font color="#704ae0">string</font>: `IPv4`
    - `mac` <font color="#704ae0">string</font>: The MAC address of the network interface
    - `internal` <font color="#704ae0">bool</font>: `true` if the network interface is a loopback or similar interface that is not remotely accessible; otherwise `false`
    - `cidr` <font color="#704ae0">string</font>: The assigned IPv4 address with the routing prefix in CIDR notation. If the `netmask` is invalid, this property is set to `null`.
  - `IPv6` <font color="#704ae0">object</font>: An object containing information about the IPv6 configuration:
    - `address` <font color="#704ae0">string</font>: The assigned IPv6 address
    - `netmask` <font color="#704ae0">string</font>: The IPv6 network mask
    - `family` <font color="#704ae0">string</font>: `IPv6`
    - `mac` <font color="#704ae0">string</font>: The MAC address of the network interface
    - `internal` <font color="#704ae0">bool</font>: `true` if the network interface is a loopback or similar interface that is not remotely accessible; otherwise `false`
    - `cidr` <font color="#704ae0">string</font>: The assigned IPv6 address with the routing prefix in CIDR notation. If the `netmask` is invalid, this property is set to `null`.
- `bootVersion` <font color="#704ae0">string</font>: The current version of the boot loader
- `fwVersion`  <font color="#704ae0">string</font>: The current version of firmware installed on the player
- `upTime` <font color="#704ae0">string</font>: The amount of time (as a human-readable string) that the player has been powered on and working correctly
- `upTimeSeconds` <font color="#704ae0">int</font>: The amount of time (in seconds) that the player has been powered on and working correctly
- `extensions` <font color="#704ae0">extension[ ]</font>: An array of Extension objects describing Firmware Extensions currently installed on the player
- `blessings` <font color="#704ae0">blessing[ ]</font>: An array of Blessing objects describing proprietary codecs that are currently authorized on the player

**Response Example**

:::ExpandableHeading
Expand

```json
{
    "route": "/v1/info",
    "method": "GET",
    "data": {
        "result": {
            "serial": "RE433D006644",
            "upTime": "30 minutes",
            "upTimeSeconds": 1832,
            "model": "XD1035",
            "FWVersion": "9.0.97",
            "bootVersion": "9.0.85",
            "family": "cobra",
            "isPlayer": true,
            "power": {
                "result": {
                    "battery": "absent",
                    "source": "AC",
                    "switch_mode": "hard"
                }
            },
            "poe": {
                "result": {
                    "status": "inactive"
                }
            },
            "extensions": {
                "result": {
                    "extensions": []
                }
            },
            "blessings": {
                "result": {
                    "ac3": false,
                    "eac3": false
                }
            },
            "networking": {
                "result": {
                    "description": "Test_player",
                    "name": "XD5-RE433D006644"
                }
            },
            "bvnPipelines": {
                "result": {
                    "pipelines": []
                }
            },
            "bvnComponents": {
                "result": {
                    "components": []
                }
            },
            "hardware_features": {
                "hdmi": true,
                "component video": false,
                "vga": false,
                "two channel audio": true,
                "ethernet": true,
                "usb": true,
                "serial port 0": true,
                "serial port 1": false,
                "gpio connector": true,
                "svc button": true,
                "reset button": true,
                "rtc": true,
                "settings rom": false,
                "microsd": false,
                "sdhc": true,
                "six channel audio": false,
                "ir blaster": true,
                "wifi": false,
                "serial port 2": false,
                "audio input": false,
                "cec": true,
                "battery": false,
                "portrait lcd": false,
                "hdmi input": false,
                "digital tuner": false,
                "spdif": true,
                "audio input loopback": false,
                "msata": false,
                "ac3": false,
                "eac3": false,
                "onboard storage": true,
                "no 4k decode": false,
                "no bluetooth": false,
                "no poe": false,
                "internal storage only": false,
                "disable packet capture": false,
                "disable bsn cloud": false,
                "brightear": false,
                "disable dws": false
            },
            "api_features": {
                "video": true
            },
            "active_features": {
                "legacyDWS": true
            },
            "connectionType": "eth0",
            "ethernet": [
                {
                    "interfaceName": "eth0",
                    "interfaceType": "Ethernet",
                    "IPv4": [
                        {
                            "address": "123.456.7.890",
                            "netmask": "255.255.255.0",
                            "family": "IPv4",
                            "mac": "90:ac:3f:2a:01:79",
                            "internal": false,
                            "cidr": "192.168.1.174/24"
                        }
                    ],
                    "IPv6": [
                        {
                            "address": "2600:1700:dac0:2060::23",
                            "netmask": "ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff",
                            "family": "IPv6",
                            "mac": "90:ac:3f:2a:01:79",
                            "internal": false,
                            "cidr": "2600:1700:dac0:2060::23/128",
                            "scopeid": 0
                        },
                        {
                            "address": "2600:1700:dac0:2060:92ac:3fff:fe2a:179",
                            "netmask": "ffff:ffff:ffff:ffff::",
                            "family": "IPv6",
                            "mac": "90:ac:3f:2a:01:79",
                            "internal": false,
                            "cidr": "2600:1700:dac0:2060:92ac:3fff:fe2a:179/64",
                            "scopeid": 0
                        },
                        {
                            "address": "fe80::92ac:3fff:fe2a:179",
                            "netmask": "ffff:ffff:ffff:ffff::",
                            "family": "IPv6",
                            "mac": "90:ac:3f:2a:01:79",
                            "internal": false,
                            "cidr": "fe80::92ac:3fff:fe2a:179/64",
                            "scopeid": 2
                        }
                    ]
                }
            ],
            "wireless": [],
            "interfaces": [],
            "bsnce": true
        }
    }
}
```
:::

## GET /v1/time/ 

Retrieves the date and time as configured on the player. The date/time value is formatted as `"yyyy-mm-dd hh:mm:ss <timezone>"`. 

**Request Example**

```text
GET /api/v1/time/ HTTP/1.1
Host: {{playerIP}}
Authorization: {{DigestAuth}}
```

**Response Example**

```json
{
    "route": "/v1/time",
    "method": "GET",
    "data": {
        "result": {
            "time": "2018-10-18 14:34:34 PDT",
            "timezone_mins": null,
            "timezone_name": "America/Los_Angeles",
            "timezone_abbr": "PDT",
            "year": 2018,
            "month": 10,
            "date": 18,
            "hour": 14,
            "minute": 34,
            "second": 34,
            "millisecond": 569
        }
    }
}

```

## PUT /v1/time/ 

Sets the time on the player. 

**Request Body**

- `date` <font color="#704ae0">string</font>: The recommended format is: "`YYYY-MM-DD`"
- `time` <font color="#704ae0">string</font>: The recommended format is: "`HH:mm`"
- `applyTimezone` <font color="#704ae0">bool</font>: This value decides if the date and time passed is in UTC or not (the default is false).

**Request Example**

```text
PUT /api/v1/time/ HTTP/1.1
Host: {{playerIP}}
Authorization: {{DigestAuth}}
Content-Type: application/json
Content-Length: 117
```

This is the example request body:

```json
{
    "data": {
        "time": "22:00:00",
        "date": "2023-11-07",
        "applyTimezone": true
    }
}
```

**Response Example**

```json
{
  "data": {
    "result": true
  }
}
```

## GET /v1/video-mode/ 

Returns the current video mode of the player

**Request Example**

```text
GET /api/v1/video-mode/ HTTP/1.1
Host: {{playerIP}}
Authorization: {{DigestAuth}}
```

**Response Body**

- `width` <font color="#704ae0">int</font>: The screen width
- `height` <font color="#704ae0">int</font>: The screen height
- `frames` <font color="#704ae0">int</font>: The frame rate
- `scan` <font color="#704ae0">string</font>: The scan method of the video signal, which can be either progressive ("p") or interlaced ("i")
- `name` <font color="#704ae0">string</font>: The full name of the video mode (a full list of modes can be found on [this page](docId\:QpML112mBhEK7LBDGUxnv))
- `isAutoMode` <font color="#704ae0">bool</font>: A flag indicating whether the video mode was set using [auto](docId\:QQ734nQz0hCwNI0uNSdMP) mode
- `mode` <font color="#704ae0">mode{ }</font>: A Mode object that gives additional information about the video output. This object can contain the following properties:
  - `preferred` <font color="#704ae0">bool</font>: A flag indicating whether the video mode is the preferred mode
  - `overscan` <font color="#704ae0">bool</font>: A flag indicating whether the video output is using an overscan setting or not
  - `modeName` <font color="#704ae0">string</font>: The full name of the video mode (a full list of modes can be found on [this page](docId\:QpML112mBhEK7LBDGUxnv))
  - `interlaced` <font color="#704ae0">bool</font>: A flag indicating whether the video output is interlaced (`true`) or progressive (`false`)
  - `width` <font color="#704ae0">int</font>: The width of the video output
  - `height` <font color="#704ae0">int</font>: The height of the video output
  - `graphicsPlaneWidth` <font color="#704ae0">int</font>: The width of the graphics plane 
  - `graphicsPlaneHeight` <font color="#704ae0">int</font>: The height of the graphics plane
  - `frequency` <font color="#704ae0">int</font>: The frame rate of the video output
  - `dropFrame` <font color="#704ae0">bool</font>: A flag indicating whether the video timecode utilizes drop frames
  - `colorSpace` <font color="#704ae0">string</font>: The color space of the video signal ("rgb", "yuv420", or "yuv422")
  - `colorDepth` <font color="#704ae0">string</font>: The color depth of the video signal ("8bit", "10bit", or "12bit")

**Response Example**

```json
{
    "route": "/v1/video-mode",
    "method": "GET",
    "data": {
        "result": {
            "isAutoMode": false,
            "name": "640x480x60p",
            "width": "640",
            "height": "480",
            "frames": "60",
            "scan": "p",
            "mode": {
                "colorDepth": "8bit",
                "colorSpace": "rgb",
                "dropFrame": false,
                "frequency": 60,
                "graphicsPlaneHeight": 480,
                "graphicsPlaneWidth": 640,
                "height": 480,
                "interlaced": false,
                "modeName": "640x480x60p",
                "overscan": false,
                "preferred": false,
                "width": 640
            }
        }
    }
}

```