additional API features added, documentation needed