adding fuinctionality to support consistent API return values