---
title: Remote DWS APIs
slug: develop/remote-dws-apis
docTags: 
createdAt: 2025-03-11T07:03:32.132Z
---

The Remote DWS allows you to view and modify settings on a BrightSign player over the Internet. The Remote DWS API is a REST framework that allows a client application to integrate with Remote DWS functionality.

The client application makes REST calls to the BrightSign WebSockets server, which in turn sends WebSockets messages to BrightSign players. Depending on the operation, the BrightSign player may return information to the BrightSign Websockets server, which will be relayed in the server REST response to the client application.

## REST URLs

The base URL of the remote DWS API is [https://ws.bsn.cloud/rest/v1/](https://ws.bsn.cloud/rest/v1/). 

Please note that the REST section is case sensitive and the server may return code 404 if the case is not matched exactly.

## Authentication

All Remote DWS API calls require a valid OAuth2 access token which maybe issued either to a user or to the client application. The target player must belong to the same network for which the token has been granted. 

Please follow the [Authentication](docId\:HbYHyV8svQ0u6bZhuV50-) to register your applications and obtain access tokens which grant access to the Remote DWS API.

### Request Headers

You should include the following request headers in your request. The Content-Type header is only needed when content is being sent in POST or PUT API calls.

```text
headers: {
	'Accept': 'application/json, application/vnd.bsn.error+json',
	'Authorization': 'Bearer {{UserAccessToken}}',
	'Content-Type': 'application/json',
}
```

## Request Message Format

HTTP requests to Remote DWS resources must be JSON formatted and contain the following URL parameters:

- `destinationType`  <font color="#704ae0">string</font>: The device type. The only currently accepted value is "player".
- `destinationName`  <font color="#704ae0">string</font>: The device serial number

Requests that require a JSON body need to have an outer data object. For instance, if a route expects `enabled` <font color="#704ae0">bool</font> then the full JSON body would look like:

```json
{
  "data": {
    "enabled": false
  }
}
```

Some requests also require resource-specific properties in the URL or request body, as detailed in the **URL Parameters** and **Request Body** sections below.

## Response Message Format

The server will respond to a REST request with a success or error message, which may also contain resource-specific properties, as detailed in the **Response Body** sections below.

Returned JSON objects will have an outer object containing the methods below, where data is an error or a result object containing the returned values:

- `route` <font color="#704ae0">string</font>: The route the request was sent to
- `method` <font color="#704ae0">string</font>: The request method
- `data` <font color="#704ae0">object</font>: The returned data

For example:

```json
{
  "route": "/v1/info",
  "method": "GET",
  "data": {
    "result": {
      "model": "LS424"
      ...
    }
  }
}
```