updated info about API responses