began writing description for service.py
reworked APIs