Update README.md

adding in some more bits of api - almost certainly wrong, just notes.