improve phpdoc
transform API responses to domain objects in API calls