# HEMS APIs

APIs for Home Energy Management System

Version: 1.0.0

## Servers

Production server
```
https://ems.obeliskapp.com
```

## Security

### bearerAuth

Type: http
Scheme: bearer
Bearer Format: JWT

## Download OpenAPI description

[HEMS APIs](https://docs-hems.obeliskapp.com/_bundle/apis/openapi.yaml)

## Organization

### Acquire an access token

 - [POST /organization/auth/token](https://docs-hems.obeliskapp.com/apis/openapi/organization/paths/~1organization~1auth~1token/post.md): Acquire an access token for accessing devices and users endpoints

## User

### Link user device

 - [POST /users/{userId}/link](https://docs-hems.obeliskapp.com/apis/openapi/user/paths/~1users~1%7Buserid%7D~1link/post.md): Link a user device to an organization

### Unlink user

 - [DELETE /users/{userId}/unlink](https://docs-hems.obeliskapp.com/apis/openapi/user/paths/~1users~1%7Buserid%7D~1unlink/delete.md): Unlink a user and delete all their devices

### List users

 - [GET /users/](https://docs-hems.obeliskapp.com/apis/openapi/user/paths/~1users~1/get.md): List users linked under an organization

### Get user

 - [GET /users/{userId}](https://docs-hems.obeliskapp.com/apis/openapi/user/paths/~1users~1%7Buserid%7D/get.md): Get user details by user id

### Get user devices

 - [GET /users/{userId}/devices](https://docs-hems.obeliskapp.com/apis/openapi/user/paths/~1users~1%7Buserid%7D~1devices/get.md): Get user devices by user id

## Device

### List all devices

 - [GET /devices/](https://docs-hems.obeliskapp.com/apis/openapi/device/paths/~1devices~1/get.md): List all devices linked under an organization

### Get a device

 - [GET /devices/{deviceId}](https://docs-hems.obeliskapp.com/apis/openapi/device/paths/~1devices~1%7Bdeviceid%7D/get.md): Get device details by ID