Esper APIs are a set of REST-based APIs that help you programmatically control and monitor devices running the Esper Agent. With these APIs, you can orchestrate and manage devices that have been provisioned against your Esper Manage environment. Furthermore, these APIs allows 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 esper.io.
To use these APIs you will need to create an account with Esper and get access to the Esper Console and the Esper Manage Dashboard. You can find out more about Esper and sign up for a free account at esper.io/signup
Esper APIs adhere to Open API specification and you can check our latest API spec on GitHub.
Authentication
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 Dev to generate your key. See Generating an API key.
Once you have the access token, you need to send an authorization header as below
curl -X GET \
https://{{ esper_tenant_name }}-api.esper.cloud/api/enterprise/:enterprise_id/device/ \
-H 'Authorization: Bearer ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
Errors
The APIs use standard HTTP status codes to indicate success or failure. All error responses will have a JSON body in the following format
python
{
"errors": [],
"message": "error message",
"status": 400
}
errorsList of error detailsmessageError descriptionstatusHTTP status code
APIs
Below are quick links to frequently used APIs. To see a full list of APIs and latest updates, please visit API documentation.
Token
Enterprise
Application
Devices
Device Groups
Device Commands
Group Commands
If you face any issues in API usage, we recommend you reach out to Esper Dev Support.