OpenAPI v3 / Swagger spec available?

The postman collection is cool, but an OpenAPIv3 spec would be useful. Any news?

Great question! It’s on the roadmap and will definitely get done. Currently you can export the documentation from Postman as a v1, 2 or 2.1 collection, which can then be converted to OpenAPI via something like

I’d like to polish the documentation a little more before providing an Official version, so look for it at the end of next week.

The OpenAPI / swagger spec is now live and linked to from the new Documentation page over at

It includes the spec for features from upcoming release:

  • /breeds
  • /facts
  • /sources