api functions exported