added functionality to API and README.md