update README with new api responses