Yes we use swagger for our API documentation and this is where the description and guidelines of API endpoints are.