additional api functions