a small test api to determine best practice for docs and api contracts