updated for web service api
documenting API