updated readme with desc and endpoint examples