comments for all api functions for sma