official swagger file work in progress... https://github.com/pelias/api/pull/1168 API End points here: https://github.com/pelias/documentation#endpoint-descriptions