# Openapi

**URL:** https://hub.mender.io/t/openapi/611
**Category:** General Discussions
**Created:** [May 23, 2019, 8:31am UTC](https://hub.mender.io/t/openapi/611 "2019-05-23T08:31:24Z")
**Posts on this page:** 3
**Page:** 1

<div class="post-metadata">

### Author: ![nickbetteridge](https://yyz2.discourse-cdn.com/flex036/user_avatar/hub.mender.io/nickbetteridge/32/408_2.png) [@nickbetteridge](https://hub.mender.io/u/nickbetteridge)
#### Post date: [May 23, 2019, 8:31am UTC](https://hub.mender.io/t/openapi/611/1 "2019-05-23T08:31:24Z")

</div>

Hi,  
Are there any Openapi yaml or json files for your rest apis? We generate all of our bindings and ensure they are type-safe. If there aren’t any, would it be possible for you to create them, thus providing us with an official contract between client and server?  
Thanks  
Nick

---

<div class="post-metadata">

### Author: ![mirzak](https://yyz2.discourse-cdn.com/flex036/user_avatar/hub.mender.io/mirzak/32/2056_2.png) [@mirzak](https://hub.mender.io/u/mirzak)
#### Post date: [May 23, 2019, 8:39am UTC](https://hub.mender.io/t/openapi/611/2 "2019-05-23T08:39:01Z")

</div>

I believe that all services have a `yaml` file containing the API definitions, e.g

> <https://github.com/mendersoftware/deployments/blob/master/docs/devices_api.yml>

Though I do not believe that we **one** file for all device API`s instead there is one definition for each service.

---

<div class="post-metadata">

### Author: ![nickbetteridge](https://yyz2.discourse-cdn.com/flex036/user_avatar/hub.mender.io/nickbetteridge/32/408_2.png) [@nickbetteridge](https://hub.mender.io/u/nickbetteridge)
#### Post date: [May 23, 2019, 8:50am UTC](https://hub.mender.io/t/openapi/611/3 "2019-05-23T08:50:52Z")

</div>

Excellent - thanks - just what I was after!