Updated API docuemtation in README.md

- added detail and formatting