README updated with API spec