# Swagger Specifications for CH API

**URL:** <http://forum.companieshouse.gov.uk/t/swagger-specifications-for-ch-api/924>\
**Category:** Uncategorized\
**Created:** [January 9, 2017, 10:30am UTC](http://forum.companieshouse.gov.uk/t/swagger-specifications-for-ch-api/924 "2017-01-09T10:30:00Z")\
**Posts on this page:** 4\
**Page:** 1

<div class="post-metadata">

**Author:** ![sushil\_suresh](http://forum.companieshouse.gov.uk/letter_avatar_proxy/v4/letter/s/9e8a1a/32.png) [@sushil\_suresh](http://forum.companieshouse.gov.uk/u/sushil_suresh)\
**Post date:** [January 9, 2017, 10:30am UTC](http://forum.companieshouse.gov.uk/t/swagger-specifications-for-ch-api/924/1 "2017-01-09T10:30:01Z")

</div>

Hi Team,

I am working on an integration with the available Companies house API. We are currently handcrafting the API definition as there are no SWAGGER/YAML definitions available to download.

Is there a plan to upload SWAGGER 2.0 definition for the API’s in the next coming months? Is there any alternate way to define definition at the consumer end at the moment?

---

<div class="post-metadata">

**Author:** ![csmith](http://forum.companieshouse.gov.uk/user_avatar/forum.companieshouse.gov.uk/csmith/32/8_2.png) [@csmith](http://forum.companieshouse.gov.uk/u/csmith)\
**Post date:** [January 9, 2017, 4:04pm UTC](http://forum.companieshouse.gov.uk/t/swagger-specifications-for-ch-api/924/2 "2017-01-09T16:04:02Z")

</div>

Hi there.

Yes, we will be releasing Swagger 2.0 JSON specifications that you can download and use with swagger-core or other tooling of your choice to build your clients.

We are rebuilding our Developer Hub documentation to use [DapperDox](http://dapperdox.io) (a documentation presentation tool we recently open sourced) and are rewriting our specifications as Swagger 2.0. We plan on releasing this over the next month or so - but this is a background task as we have higher priority work to be completed too!

Hope that will help?

---

<div class="post-metadata">

**Author:** ![sushil\_suresh](http://forum.companieshouse.gov.uk/letter_avatar_proxy/v4/letter/s/9e8a1a/32.png) [@sushil\_suresh](http://forum.companieshouse.gov.uk/u/sushil_suresh)\
**Post date:** [January 9, 2017, 4:44pm UTC](http://forum.companieshouse.gov.uk/t/swagger-specifications-for-ch-api/924/3 "2017-01-09T16:44:03Z")

</div>

thanks and good to know this is in the bucket list as without Swagger life does get a bit tedious 😄

---

<div class="post-metadata">

**Author:** ![rjo](http://forum.companieshouse.gov.uk/user_avatar/forum.companieshouse.gov.uk/rjo/32/443_2.png) [@rjo](http://forum.companieshouse.gov.uk/u/rjo)\
**Post date:** [September 8, 2017, 5:11pm UTC](http://forum.companieshouse.gov.uk/t/swagger-specifications-for-ch-api/924/4 "2017-09-08T17:11:20Z")

</div>

Any updates no the Swagger 2 spec being published? We’re half a year on from your “next month or so” and I don’t see it anywhere obvious!