Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Esper Device API

APIs for device management

Esper Device API is one of 13 APIs that Esper publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Device. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, and authentication docs.

This API exposes 6 operations across 6 paths, and defines 9 schemas. It is described by OpenAPI 2.0, at version 1.0.0.

Requests are made against the base URL https://foo-api.esper.cloud/api.

6 operations 6 paths 9 schemas 6 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 2.0
API Version
1.0.0
Base URL
https://foo-api.esper.cloud/api
Authentication
API Key
License
Terms of Service
Resource Areas
1

Authentication & Security 1

Esper Device API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (apiKey).

  • apiKey — API KEY - Access Token Access token for APIs passed as authorization header in calls. You need to generate this from your Esper Dev Console at -api.esper.cloud…

Paths & Operations 6

Across 6 paths, the API surfaces 6 operations — 6 GET. Each is listed below with its method, path, parameters, and response codes.

Device 6

APIs for device management

GET
/enterprise/{enterprise_id}/device/
Fetch all devices in an enterprise
getAllDevices 12 params → 200
GET
/enterprise/{enterprise_id}/device/{device_id}/
Fetch device details by ID
getDeviceById 2 params → 200400
GET
/enterprise/{enterprise_id}/device/{device_id}/app/
List all device apps
getDeviceApps 7 params → 200
GET
/enterprise/{enterprise_id}/device/{device_id}/app/{app_id}/
Get device app details
getDeviceAppById 3 params → 200
GET
/enterprise/{enterprise_id}/device/{device_id}/install/
List installed apps
getAppInstalls 8 params → 200
GET
/enterprise/{enterprise_id}/device/{device_id}/status/
Get latest device event
getDeviceEvent 3 params → 200

Schemas 9

The contract defines 9 schemas that model the data the API accepts and returns. The most detailed are Device (30 properties), DeviceApp (14 properties), EmmDevice (9 properties), AppInstall (9 properties). Each schema is shown below with its type and property counts.

EmmDevice
object
9 properties
DeviceApp
object
14 properties 3 required
AppInstallApplication
object
4 properties
Device
object
30 properties
AppInstallStateEnum
string
Device App Install State NOTINSTALLED = "Not Installed" INSTALLINPROGRESS = "Installation In-Progress" UNINSTALLINPROGRESS = "Uninstallation In-Progress" INSTA…
AppInstallVersion
object
4 properties
AppInstall
object
9 properties 4 required
DeviceStatus
object
5 properties 3 required
DeviceAppPermission
object
7 properties 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

esper-device-api-openapi.yml Raw ↑

Other APIs Esper publishes across the network.

Esper Application API
Esper Application V1 API
Esper Commands API
Esper Commands V2 API
Esper Content API
Esper Device Group API
Esper Enterprise API
Esper Enterprise Policy API
Esper Geofence API
Esper Group Commands API
Esper Subscription API
Esper Token API