Download OpenAPI specification:Download


Esper APIs are a set of REST-based APIs that help you programmatically control and monitor Android-based Dedicated Devices running the Esper Agent using the Esper Console. With these APIs, you can orchestrate and manage devices that have been provisioned against your Esper Console environment. Furthermore, these APIs allow you to manage the Android applications installed on your Dedicated Device fleet. To read more about the various capabilities of Esper APIs and Esper managed devices, please visit This guide describes all the available APIs in detail, along with code samples for you to quickly ramp up to using them.
You need to create a developer account with Esper and access the Esper Console to use these APIs. You can find out more about Esper and sign up for a free account at

We've done our best to keep this document up to date, but please reach out to us at if you have any concerns.


You are welcome to use your favorite HTTP/REST library for your programming language in order to call these APIs, or you can use our SDK (currently supporting python) to do so.


The client needs to send authentication details to access the Esper APIs by generating and applying an API key. Be sure to sign up for your free trial account with Esper to generate your key:


The APIs use standard HTTP status codes to indicate success or failure. All error responses will have a JSON body in the following format:

  "errors": [],
  "message": "error message",
  "status": 400
  • errors - List of error details
  • message - Error description
  • status - HTTP status code