final draft of services api