Swagger specification

Hi

We use Swagger specification files to generate code for our own internal micro-services. I saw a couple of references to a swagger specification being drafted and being made public. And so we intend to do the same with Companies House.

Is there any chance of getting hold of a swagger spec? It does not need to be final but would be great if it was available. If we could see a draft that would mean we could save on rewriting the public facing website as a swagger spec ourselves…

Thanks
Chris

1 Like

The developer hub documentation (and api explorer) is entirely driven by Swagger specifications). The Swagger spec moved from 1.1 to 1.2 while we were building our dev hub, and so the Swagger specs we have are a mashup of both those versions, and as such not releasable :frowning:

However, we are currently migrating to Swagger 2.0, which includes upgrading our documentation generator (which will be made public on GitHub). Once this is done, the Swagger specifications will be downloadable at-a-click from the dev hub. Can’t give you a “when” just yet, but it is work being done now.

Well, something is better than nothing. If we could generate client code from 1.1/1.2 swagger descriptions it would save us plenty of time developing api clients separately.

+1 Anything would be great :slight_smile: But good news that we will have some 2.0 specs soon…

+1 It will be very welcome!