Skip to content

HTTP API Reference

The HTTP API allows you to integrate remote access and device management capabilities into your own services, applications, or internal systems. It enables you to automate work with devices, connections, users, and other platform entities without the need to perform actions manually in the control panel. The API is suitable for partners, developers, and companies that need to embed remote access functionality into their business processes or products.

Integration Example

Explore integration examples in the technician guides under the HTTP API section.


Requests

All requests must be made over the HTTPS (not HTTP) protocol with an appropriate method for each command at URL:

https://api.getscreen.me/v1/

Authentication

API is RESTful: the server doesn't store the client connection state. That's why the client must send authorization data each time a request is sent. An API key is used as such data. Add the key in each request in the X-Api-Key HTTP header:

GET /
Host: https://api.getscreen.me
X-Api-Key: YOUR_API_KEY
curl -X GET "https://api.getscreen.me/" \
-H "X-Api-Key: YOUR_API_KEY" \

Where can I get an API key?

Your API key can be found in your personal profile in the Integration section of the HTTP API tab.


Responses

Data responses are returned in JSON UTF-8 with ContentType: application/json. Each response wraps data in the data JSON container.

The API server may return the following HTTP response codes:

HTTP response code Description
200 OK Request accepted and processed
400 Bad Request Request denied, invalid parameters, error
402 Payment Required Request rejected, request limit for the service plan exceeded
403 Forbidden Request denied, no access to data
404 Not Found Request denied, unknown request URL

Available Methods

You can find detailed descriptions of the available methods on separate pages. For your convenience, we have grouped these methods by system function so that they match the structure of the control panel interface:

  • Permanent Access


    Methods for managing devices, groups, and software.

    Learn more

  • Quick Support


    Methods for managing customer invitations.

    Learn more

  • Connection History


    Methods for retrieving information about the history of all connections.

    Learn more