added more details in the API and the wrapper