README with new api