MIFOSX-1709 : added test cases and api documentation